Company Enrichment

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"
}
'

import requests

url = "https://api.datalegion.ai/company/enrich"

payload = { "domain": "stripe.com" }
headers = {
    "API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({domain: 'stripe.com'})
};

fetch('https://api.datalegion.ai/company/enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.datalegion.ai/company/enrich",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'domain' => 'stripe.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "API-Key: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.datalegion.ai/company/enrich"

	payload := strings.NewReader("{\n  \"domain\": \"stripe.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.datalegion.ai/company/enrich")
  .header("API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"stripe.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.datalegion.ai/company/enrich")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"stripe.com\"\n}"

response = http.request(request)
puts response.read_body

{
  "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.2_2026-07-12"
      },
      "match_metadata": {
        "matched_on": [
          "domain"
        ],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

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"
}
'

import requests

url = "https://api.datalegion.ai/company/enrich"

payload = { "domain": "stripe.com" }
headers = {
    "API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({domain: 'stripe.com'})
};

fetch('https://api.datalegion.ai/company/enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.datalegion.ai/company/enrich",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'domain' => 'stripe.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "API-Key: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.datalegion.ai/company/enrich"

	payload := strings.NewReader("{\n  \"domain\": \"stripe.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.datalegion.ai/company/enrich")
  .header("API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"stripe.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.datalegion.ai/company/enrich")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"stripe.com\"\n}"

response = http.request(request)
puts response.read_body

{
  "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.2_2026-07-12"
      },
      "match_metadata": {
        "matched_on": [
          "domain"
        ],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

Minimum Requirements

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

Identifiers

Field	Description	Example
`legion_id`	Company Legion ID (exact match)	`c8a1b2c3-d4e5-6f7a-8b9c-0d1e2f3a4b5c`
`domain`	Company website domain	`google.com`
`name`	Company name (fuzzy matching)	`Google`
`linkedin_id`	LinkedIn company numeric ID	`1441`
`social_url`	LinkedIn company page or other social URL	`https://linkedin.com/company/google`
`ticker_symbol`	Stock ticker symbol	`GOOGL`

Qualifiers

These fields refine matching but are not sufficient on their own:

Field	Description
`industry`	Narrows name-based matching (e.g., `"software development"`)

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 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.

Show child attributes

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 exact count exceeds its time budget (broad, low-selectivity queries) it falls back to the query planner's row estimate, and if that is unavailable, to the size of the returned page; the response header Total-Count-Status reports which (exact, estimate, or page).

Person Discovery (Beta)Company Search (Beta)

API Reference

Person

Company

Utilities

Minimum Requirements

Identifiers

Qualifiers

Authorizations

Body

Response

​Minimum Requirements

​Identifiers

​Qualifiers

Authorizations

Body

Response

Minimum Requirements

Identifiers

Qualifiers