Skip to main content
POST
/
company
/
enrich
Enrich company by multiple parameters
curl --request POST \
  --url https://api.datalegion.ai/company/enrich \
  --header 'API-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "stripe.com"
}
'
{
  "matches": [
    {
      "company": {
        "legion_id": "c8a1b2c3-d4e5-6f7a-8b9c-0d1e2f3a4b5c",
        "name": {
          "cleaned": "stripe inc",
          "display": "Stripe",
          "raw": [
            "Stripe, Inc.",
            "Stripe"
          ]
        },
        "headline": {
          "cleaned": "financial infrastructure for the internet",
          "raw": [
            "Financial infrastructure for the internet"
          ]
        },
        "description": {
          "cleaned": "stripe is a financial infrastructure platform for businesses...",
          "raw": [
            "Stripe is a financial infrastructure platform for businesses..."
          ]
        },
        "domain": "stripe.com",
        "linkedin_url": "https://www.linkedin.com/company/stripe",
        "linkedin_id": "2135371",
        "linkedin_followers": 1250000,
        "linkedin_employee_count": 8000,
        "industry": "financial services",
        "type": "private",
        "size": "5001-10000",
        "founded": 2010,
        "legion_employee_count": 8500,
        "legion_average_tenure": 28.4,
        "legion_new_hire_count": {
          "1m": 85,
          "3m": 240,
          "6m": 420,
          "12m": 780
        },
        "legion_attrition_count": {
          "1m": 35,
          "3m": 95,
          "6m": 170,
          "12m": 310
        },
        "legion_employee_growth_rate": {
          "1m": 0.012,
          "3m": 0.035,
          "6m": 0.068,
          "12m": 0.125
        },
        "legion_turnover_rate": {
          "1m": 0.004,
          "3m": 0.011,
          "6m": 0.02,
          "12m": 0.036
        },
        "legion_seniority_distribution": {
          "c_level": 15,
          "vp": 85,
          "director": 320,
          "manager": 1100,
          "senior": 2800,
          "junior": 3200
        },
        "legion_job_function_distribution": {
          "engineering": 3400,
          "sales": 1200,
          "operations": 800,
          "marketing": 600,
          "information_technology": 500,
          "product": 450
        },
        "legion_expense_category_distribution": {
          "research_and_development": 3850,
          "general_and_administrative": 2850,
          "sales_and_marketing": 1800
        },
        "legion_tenure_distribution": {
          "<1yr": 1200,
          "1-2yr": 2100,
          "2-5yr": 3200,
          "5-10yr": 1400,
          "10+yr": 600
        },
        "legion_education_distribution": {
          "bachelors": 4200,
          "masters": 2800,
          "high_school": 950,
          "associates": 400,
          "doctorate": 150
        },
        "legion_seniority_growth_rate": {
          "senior": {
            "1m": 0.015,
            "3m": 0.04,
            "6m": 0.08,
            "12m": 0.15
          }
        },
        "legion_job_function_growth_rate": {
          "engineering": {
            "1m": 0.018,
            "3m": 0.05,
            "6m": 0.09,
            "12m": 0.17
          }
        },
        "legion_expense_category_growth_rate": {
          "research_and_development": {
            "1m": 0.016,
            "3m": 0.045,
            "6m": 0.085,
            "12m": 0.16
          }
        },
        "tickers": [],
        "socials": [
          {
            "network": "x",
            "url": "https://www.x.com/stripe",
            "username": "stripe",
            "id": "16177321"
          },
          {
            "network": "github",
            "url": "https://github.com/stripe",
            "username": "stripe",
            "id": null
          }
        ],
        "domains": [
          {
            "domain": "stripe.com"
          },
          {
            "domain": "stripe.dev"
          }
        ],
        "legion_employee_count_by_month": [
          {
            "month": "2026-01",
            "count": 8500,
            "net_change": 50,
            "growth_rate": 0.006,
            "hires": 120,
            "departures": 70
          },
          {
            "month": "2025-12",
            "count": 8450,
            "net_change": 65,
            "growth_rate": 0.008,
            "hires": 135,
            "departures": 70
          }
        ],
        "num_sources": 5,
        "last_seen": "2026-01",
        "build_version": "1.3.0_2026-05-12"
      },
      "match_metadata": {
        "matched_on": [
          "domain"
        ],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}

​
Minimum Requirements

Every request must include at least one identifier. Requests with no identifiers return 400 Bad Request.

​
Identifiers

FieldDescriptionExample
legion_idCompany Legion ID (exact match)c8a1b2c3-d4e5-6f7a-8b9c-0d1e2f3a4b5c
domainCompany website domaingoogle.com
nameCompany name (fuzzy matching)Google
linkedin_idLinkedIn company numeric ID1441
social_urlLinkedIn company page or other social URLhttps://linkedin.com/company/google
ticker_symbolStock ticker symbolGOOGL

​
Qualifiers

These fields refine matching but are not sufficient on their own:
FieldDescription
industryNarrows name-based matching (e.g., "technology")

Authorizations

​
API-Key
string
header
required

Body

application/json

Request model for company enrichment.

​
legion_id
string | null

Company Legion ID (exact match)

​
domain
string | null

Company website domain (e.g., google.com)

​
name
string | null

Company name (fuzzy matching)

​
linkedin_id
string | null

LinkedIn company numeric ID

​
social_url
string | null

Social profile URL (LinkedIn, Facebook, Crunchbase, X/Twitter, GitHub - will be normalized and detected)

​
ticker_symbol
string | null

Stock ticker symbol (e.g., GOOGL)

​
industry
string | null

Industry filter (used with name matching for better accuracy)

​
multiple_results
boolean
default:false

If true, return multiple matches sorted by confidence

​
limit
integer
default:2

Maximum results when multiple_results=true (default: 2, max: 10)

Required range: 1 <= x <= 10
​
min_confidence
string | null

Minimum match confidence: 'high', 'moderate', or 'low'

​
titlecase
boolean
default:false

If true, format text fields in title case (names, company names, locations). Raw fields, IDs, URLs, codes, and confidence fields are excluded.

​
required_fields
string | null

Comma-separated list of fields that must be present, else the match is filtered out. Supports top-level fields ('domain,socials'), a non-empty list subfield ('socials.network'), or a subfield equal to a value ('type:public', 'socials.network:linkedin'). Unknown field names or out-of-range enum values return HTTP 400.

​
include_fields
string | null

Comma-separated list of fields to include in response. If omitted, all fields are returned.

​
exclude_fields
string | null

Comma-separated list of fields to exclude from response. Applied after include_fields filter.

​
pretty_print
boolean
default:false

If true, pretty-print JSON response with indentation.

Response

Success - company/companies found

​
matches
CompanyMatchResponse · object[]
required

List of matches sorted by confidence (descending). Capped at the request's limit.

​
total
integer
required

For /company/search and /company/discover, the total number of rows matching the query's WHERE clause across the database (not just this page). For /company/enrich, the number of matches found for the input identifier. On search/discover, if the count subquery fails or times out, this falls back to the size of the returned page; the response header Total-Count-Status distinguishes the two cases.