Field Reference

Complete field reference for the company data schema. Fields are organized by category.

Core Identity

Field	Type	Nullable	Description
`legion_id`	string	No	Stable company identifier (UUID)
`name`	object	No	Company name with `cleaned`, `display`, and `raw` variants
`name.cleaned`	string	No	Lowercased, standardized name for matching and filtering
`name.display`	string	No	Best-quality company name with original casing preserved (e.g., `"FoodPop"`, `"AT&T"`). Ideal for UI rendering.
`name.raw[]`	array	No	All raw name forms observed across sources
`headline`	object	Yes	Company headline/tagline with `cleaned` and `raw` variants
`headline.cleaned`	string	Yes	Headline text (normalized)
`headline.raw[]`	array	Yes	Headline raw snippets observed across sources
`description`	object	Yes	Company description with `cleaned` and `raw` variants
`description.cleaned`	string	Yes	Description text (normalized)
`description.raw[]`	array	Yes	Description raw snippets observed across sources
`domain`	string	Yes	Primary company domain (e.g., `google.com`)
`industry`	enum	Yes	Industry classification (see Enums)
`type`	enum	Yes	Company type (see Enums)
`size`	enum	Yes	Size range (see Enums)
`founded`	integer	Yes	Year company was founded

LinkedIn Profile

Field	Type	Nullable	Description
`linkedin_url`	string	Yes	LinkedIn company page URL
`linkedin_id`	string	Yes	LinkedIn numeric company ID
`linkedin_followers`	integer	Yes	LinkedIn follower count
`linkedin_employee_count`	integer	Yes	LinkedIn-reported employee count

Financial

Field	Type	Nullable	Description
`tickers`	array	No	Array of ticker objects
`tickers[].symbol`	string	No	Ticker symbol (e.g., `GOOGL`)
`tickers[].exchange`	string	Yes	Stock exchange (see Enums)

Workforce Overview

Field	Type	Nullable	Description
`legion_employee_count`	integer	Yes	Employee count derived from person data
`legion_average_tenure`	number	Yes	Average employee tenure in months

Hiring & Attrition

The time windows end at the as-of month: the last month of legion_employee_count_by_month, the same for every company in a release. Job changes reach profiles months after they happen, so the windows stop at the latest month most profiles have been updated since, instead of at the release date. See Data Freshness.

Field	Type	Nullable	Description
`legion_new_hire_count`	object	Yes	New hires in the 1, 3, 6, and 12 months ending at the as-of month
`legion_new_hire_count.1m`	integer	Yes	New hires in the as-of month
`legion_new_hire_count.3m`	integer	Yes	New hires in the 3 months ending at the as-of month
`legion_new_hire_count.6m`	integer	Yes	New hires in the 6 months ending at the as-of month
`legion_new_hire_count.12m`	integer	Yes	New hires in the 12 months ending at the as-of month
`legion_attrition_count`	object	Yes	Departures in the 1, 3, 6, and 12 months ending at the as-of month
`legion_attrition_count.1m`	integer	Yes	Departures in the as-of month
`legion_attrition_count.3m`	integer	Yes	Departures in the 3 months ending at the as-of month
`legion_attrition_count.6m`	integer	Yes	Departures in the 6 months ending at the as-of month
`legion_attrition_count.12m`	integer	Yes	Departures in the 12 months ending at the as-of month

Growth & Turnover

Field	Type	Nullable	Description
`legion_employee_growth_rate`	object	Yes	Headcount growth over the 1, 3, 6, and 12 months ending at the as-of month
`legion_employee_growth_rate.1m`	number	Yes	Growth from 1 month before the as-of month to the as-of month
`legion_employee_growth_rate.3m`	number	Yes	Growth from 3 months before the as-of month to the as-of month
`legion_employee_growth_rate.6m`	number	Yes	Growth from 6 months before the as-of month to the as-of month
`legion_employee_growth_rate.12m`	number	Yes	Growth from 12 months before the as-of month to the as-of month
`legion_turnover_rate`	object	Yes	Departures over the 1, 3, 6, and 12 months ending at the as-of month, divided by headcount at the start
`legion_turnover_rate.1m`	number	Yes	Turnover over the as-of month
`legion_turnover_rate.3m`	number	Yes	Turnover over the 3 months ending at the as-of month
`legion_turnover_rate.6m`	number	Yes	Turnover over the 6 months ending at the as-of month
`legion_turnover_rate.12m`	number	Yes	Turnover over the 12 months ending at the as-of month

Workforce Distributions

Field	Type	Nullable	Description
`legion_seniority_distribution`	object	Yes	Employee count by seniority level
`legion_job_function_distribution`	object	Yes	Employee count by job function
`legion_expense_category_distribution`	object	Yes	Employee count by P&L expense category
`legion_tenure_distribution`	object	Yes	Employee count by tenure bucket
`legion_education_distribution`	object	Yes	Employee count by education level

Distribution Growth Rates

Field	Type	Nullable	Description
`legion_seniority_growth_rate`	object	Yes	Growth rate per seniority level (nested time buckets)
`legion_job_function_growth_rate`	object	Yes	Growth rate per job function (nested time buckets)
`legion_expense_category_growth_rate`	object	Yes	Growth rate per expense category (nested time buckets)

Domains & Socials

Field	Type	Nullable	Description
`domains`	array	No	Array of domain objects
`domains[].domain`	string	Yes	Associated company domain
`socials`	array	No	Social media profiles
`socials[].network`	enum	No	Social network (see Enums)
`socials[].url`	string	No	Profile URL
`socials[].username`	string	Yes	Username/handle
`socials[].id`	string	Yes	Account ID

Locations

Office addresses, merged across sources: each entry is one office, however many sources report it. The primary location comes first, then offices still operating, then closed ones; each group is newest first. A company whose only known location is its country has a country-level entry (country filled, street, city, state, and postal code empty).

Field	Type	Nullable	Description
`locations`	array	No	Array of location objects
`locations[].street_address`	string	Yes	Street address
`locations[].address_line_2`	string	Yes	Suite, floor, or unit
`locations[].city`	string	Yes	City (lowercase)
`locations[].state`	string	Yes	State or province (lowercase)
`locations[].state_code`	string	Yes	ISO 3166-2 code of the state, province, or region (e.g., `US-MD`, `ES-CT`)
`locations[].country`	string	Yes	Country (lowercase)
`locations[].country_code`	string	Yes	ISO 3166-1 alpha-2 code
`locations[].continent`	string	Yes	Continent (lowercase)
`locations[].continent_code`	string	Yes	Continent code
`locations[].postal_code`	string	Yes	Postal code
`locations[].geo`	string	Yes	Latitude and longitude (`lat,lng`)
`locations[].raw`	array	No	Address strings as the sources wrote them
`locations[].current`	boolean	No	The office is still operating
`locations[].primary`	boolean	No	The company’s primary location (headquarters). At most one per company, and only on a current office
`locations[].num_sources`	integer	No	Number of sources that reported this location
`locations[].last_seen`	string	Yes	Most recent date a source reported this location

Employee Count by Month

Field	Type	Nullable	Description
`legion_employee_count_by_month`	array	No	Monthly headcount, hires, and departures, up to 60 months, ending at the as-of month
`legion_employee_count_by_month[].month`	string	No	Month of snapshot (e.g., `2026-01`)
`legion_employee_count_by_month[].count`	integer	No	Employee count at month end
`legion_employee_count_by_month[].net_change`	integer	Yes	Net change from previous month
`legion_employee_count_by_month[].growth_rate`	number	Yes	Growth rate from previous month
`legion_employee_count_by_month[].hires`	integer	Yes	People who started at the company during the month (a promotion is not a hire)
`legion_employee_count_by_month[].departures`	integer	Yes	People who left the company during the month (a promotion is not a departure)

Metadata

Field	Type	Nullable	Description
`num_sources`	integer	No	Count of contributing sources
`last_seen`	string	Yes	Month the record was last seen (YYYY-MM format)
`build_version`	string	No	Schema version identifier

Schema Example - See a complete example record
Data Tiers - Base vs premium field availability
Dataset Statistics - Coverage statistics and field fill rates
Enum Values - All possible enum values
Data Quality - Understanding confidence levels

Getting Started

Person Data

Company Data

Data Quality

Data Standardization

SDKs

Integrations

Core Identity

LinkedIn Profile

Financial

Workforce Overview

Hiring & Attrition

Growth & Turnover

Workforce Distributions

Distribution Growth Rates

Domains & Socials

Locations

Employee Count by Month

Metadata

​Core Identity

​LinkedIn Profile

​Financial

​Workforce Overview

​Hiring & Attrition

​Growth & Turnover

​Workforce Distributions

​Distribution Growth Rates

​Domains & Socials

​Locations

​Employee Count by Month

​Metadata

​Related Documentation

Core Identity

LinkedIn Profile

Financial

Workforce Overview

Hiring & Attrition

Growth & Turnover

Workforce Distributions

Distribution Growth Rates

Domains & Socials

Locations

Employee Count by Month

Metadata

Related Documentation