Skip to main content
Complete field reference for the company data schema. Fields are organized by category.

Core Identity

FieldTypeNullableDescription
legion_idstringNoStable company identifier (UUID)
nameobjectNoCompany name with cleaned and raw variants
headlineobjectYesCompany headline/tagline with cleaned and raw variants
descriptionobjectYesCompany description with cleaned and raw variants
domainstringYesPrimary company domain (e.g., google.com)
industryenumYesIndustry classification (see Enums)
typeenumYesCompany type (see Enums)
sizeenumYesSize range (see Enums)
foundedintegerYesYear company was founded

LinkedIn Profile

FieldTypeNullableDescription
linkedin_urlstringYesLinkedIn company page URL
linkedin_idstringYesLinkedIn numeric company ID
linkedin_followersintegerYesLinkedIn follower count
linkedin_employee_countintegerYesLinkedIn-reported employee count

Financial

FieldTypeNullableDescription
tickersarrayNoArray of ticker objects
tickers[].symbolstringNoTicker symbol (e.g., GOOGL)
tickers[].exchangestringYesStock exchange (see Enums)

Workforce Overview

FieldTypeNullableDescription
legion_employee_countintegerYesEmployee count derived from person data
legion_average_tenurenumberYesAverage employee tenure in months

Hiring & Attrition

FieldTypeNullableDescription
legion_new_hire_countobjectYesNew hire counts by time period
legion_new_hire_count.1mintegerYesNew hires in last 1 month
legion_new_hire_count.3mintegerYesNew hires in last 3 months
legion_new_hire_count.6mintegerYesNew hires in last 6 months
legion_new_hire_count.12mintegerYesNew hires in last 12 months
legion_attrition_countobjectYesAttrition counts by time period
legion_attrition_count.1mintegerYesDepartures in last 1 month
legion_attrition_count.3mintegerYesDepartures in last 3 months
legion_attrition_count.6mintegerYesDepartures in last 6 months
legion_attrition_count.12mintegerYesDepartures in last 12 months

Growth & Turnover

FieldTypeNullableDescription
legion_employee_growth_rateobjectYesEmployee growth rate by time period
legion_employee_growth_rate.1mnumberYesGrowth rate over last 1 month
legion_employee_growth_rate.3mnumberYesGrowth rate over last 3 months
legion_employee_growth_rate.6mnumberYesGrowth rate over last 6 months
legion_employee_growth_rate.12mnumberYesGrowth rate over last 12 months
legion_turnover_rateobjectYesEmployee turnover rate by time period
legion_turnover_rate.1mnumberYesTurnover rate over last 1 month
legion_turnover_rate.3mnumberYesTurnover rate over last 3 months
legion_turnover_rate.6mnumberYesTurnover rate over last 6 months
legion_turnover_rate.12mnumberYesTurnover rate over last 12 months

Workforce Distributions

FieldTypeNullableDescription
legion_seniority_distributionobjectYesEmployee count by seniority level
legion_job_function_distributionobjectYesEmployee count by job function
legion_expense_category_distributionobjectYesEmployee count by P&L expense category
legion_tenure_distributionobjectYesEmployee count by tenure bucket
legion_education_distributionobjectYesEmployee count by education level

Distribution Growth Rates

FieldTypeNullableDescription
legion_seniority_growth_rateobjectYesGrowth rate per seniority level (nested time buckets)
legion_job_function_growth_rateobjectYesGrowth rate per job function (nested time buckets)
legion_expense_category_growth_rateobjectYesGrowth rate per expense category (nested time buckets)

Domains & Socials

FieldTypeNullableDescription
domainsarrayNoArray of domain objects
domains[].domainstringYesAssociated company domain
socialsarrayNoSocial media profiles
socials[].networkenumNoSocial network (see Enums)
socials[].urlstringNoProfile URL
socials[].usernamestringYesUsername/handle
socials[].idstringYesAccount ID

Employee Count by Month

FieldTypeNullableDescription
legion_employee_count_by_montharrayNoMonthly employee count snapshots
legion_employee_count_by_month[].monthstringNoMonth of snapshot (e.g., 2026-01)
legion_employee_count_by_month[].countintegerNoEmployee count at month end
legion_employee_count_by_month[].net_changeintegerYesNet change from previous month
legion_employee_count_by_month[].growth_ratenumberYesGrowth rate from previous month
legion_employee_count_by_month[].hiresintegerYesNumber of hires during the month
legion_employee_count_by_month[].departuresintegerYesNumber of departures during the month

Metadata

FieldTypeNullableDescription
num_sourcesintegerNoCount of contributing sources
last_seenstringYesMonth the record was last seen (YYYY-MM format)
build_versionstringNoSchema version identifier