Skip to main content
Complete reference for all fields in the person data schema, organized by category.

​
Core Identity

FieldTypeNullableDescription
legion_idstringNoStable contact identifier
full_namestringNoBest-available full name
first_namestringNoFirst name
middle_namestringYesMiddle name (non-initial)
middle_initialstringYesMiddle initial (provided or derived)
last_namestringNoLast name
last_initialstringNoLast name initial
suffixstringYesName suffix
prefixstringYesName prefix
sexenumYesSex value (see Enums)

​
Birth & Age

FieldTypeNullableDescription
birth_datestringYesBirth date (precision preserved, ISO 8601 format)
birth_yearintegerYesBirth year
birth_monthintegerYesBirth month
birth_dayintegerYesBirth day
ageintegerYesDerived age

​
Current Employment

FieldTypeNullableDescription
job_titlestringYesCurrent job title (derived from experience)
company_namestringYesCurrent company name (derived from experience)
company_domainstringYesCurrent company domain (derived from experience)
company_industryenumYesCurrent company industry (see Enums)
company_sizeenumYesCurrent company size (see Enums)
company_legion_idstringYesCurrent company stable identifier
company_linkedin_urlstringYesCurrent company LinkedIn URL
company_linkedin_idstringYesCurrent company LinkedIn ID
seniority_levelenumYesSeniority level (see Enums)
job_functionenumYesJob function (see Enums)
expense_categoryenumYesP&L expense category (see Enums)
is_decision_makerbooleanYesTrue if seniority is c_level/owner/partner/vp/director
years_of_experienceintegerYesYears since earliest job start date
avg_tenure_monthsnumberYesAverage job tenure in months across all experience entries

​
Contact Information

​
Top-Level Fields

FieldTypeNullableDescription
work_emailstringYesCurrent work email (professional, current=true)
mobile_phonestringYesCurrent mobile phone (mobile, current=true)

​
Phones Array

FieldTypeNullableDescription
phones[]arrayNoArray of phone objects
phones[].typeenumNoPhone type (see Enums)
phones[].numberstringNoPhone number (E.164 format)
phones[].currentbooleanNoPhone flagged current
phones[].last_seenstringYesPhone last-seen date
phones[].num_sourcesintegerNoNumber of sources that contributed to this phone
phones[].confidenceenumNoPhone quality score (see Quality Scoring)

​
Emails Array

FieldTypeNullableDescription
emails[]arrayNoArray of email objects
emails[].addressstringNoEmail address
emails[].typeenumYesEmail type (see Enums)
emails[].currentboolean/nullYesCurrent status (null for personal emails)
emails[].last_seenstringYesEmail last-seen date
emails[].validatedbooleanNoEmail validated
emails[].validation_statusenumYesValidation status (see Enums)
emails[].num_sourcesintegerNoNumber of sources that contributed to this email
emails[].confidenceenumNoEmail quality score (see Quality Scoring)
emails[].hash_sha256stringYesSHA-256 hash of email address
emails[].hash_sha1stringYesSHA-1 hash of email address
emails[].hash_md5stringYesMD5 hash of email address

​
Location

​
Top-Level Fields

FieldTypeNullableDescription
citystringYesCurrent city (from current location)
statestringYesCurrent state/province (from current location)
state_codestringYesCurrent state ISO 3166-2 code (e.g., US-CA)
countrystringYesCurrent country (from current location)
country_codestringYesCurrent country ISO 3166-1 alpha-2 code (e.g., US)

​
Locations Array

FieldTypeNullableDescription
locations[]arrayNoArray of location objects
locations[].street_addressstringYesStreet address
locations[].address_line_2stringYesAddress line 2
locations[].citystringYesCity name
locations[].statestringYesState/province name (lowercase)
locations[].state_codestringYesISO 3166-2 code (e.g., US-NY)
locations[].countrystringYesCountry name (lowercase)
locations[].country_codestringYesISO 3166-1 alpha-2 code (e.g., US)
locations[].continentstringYesContinent name
locations[].continent_codestringYesContinent code
locations[].postal_codestringYesPostal code
locations[].raw[]arrayNoRaw location from the source
locations[].currentbooleanNoLocation flagged current
locations[].num_sourcesintegerNoNumber of sources that contributed to this location
locations[].confidenceenumYesLocation quality score
locations[].last_seenstringYesLocation last-seen date

​
LinkedIn Profile

FieldTypeNullableDescription
linkedin_urlstringYesPrimary LinkedIn profile URL (current=true)
linkedin_idstringYesLinkedIn numeric ID
linkedin_followersintegerYesLinkedIn follower count
linkedin_connectionsintegerYesLinkedIn connection count

​
Skills & Languages

​
Skills Array

FieldTypeNullableDescription
skills[]arrayNoArray of skills objects
skills[].cleanedstringYesSkills text (normalized)
skills[].raw[]arrayNoSkills raw snippets

​
Languages Array

FieldTypeNullableDescription
languages[]arrayNoArray of languages objects
languages[].cleanedstringYesLanguages text (normalized)
languages[].raw[]arrayNoLanguages raw snippets
languages[].proficiencyenumYesLanguages proficiency level

​
Professional Summary

FieldTypeNullableDescription
headlineobjectNoObject containing headline text and raw snippets
headline.cleanedstringYesHeadline text (normalized)
headline.raw[]arrayNoHeadline raw snippets
summaryobjectYesObject containing summary text and raw snippets
summary.cleanedstringYesSummary text (normalized)
summary.raw[]arrayNoSummary raw snippets

​
Work Experience

Rich job history: Career progression with experience arrays, job transitions, tenure tracking, and career context, not just current role.
FieldTypeNullableDescription
experience[]arrayNoExperience entries (ordered by current status and date)
experience[].titleobjectYesExperience title object
experience[].title.cleanedstringYesExperience title cleaned value
experience[].title.raw[]arrayYesExperience title raw snippets
experience[].seniority_levelenumYesSeniority level classification
experience[].job_functionenumYesJob function classification
experience[].expense_categoryenumYesP&L expense category
experience[].is_decision_makerbooleanYesTrue if seniority is c_level/owner/partner/vp/director
experience[].organizationobjectYesExperience organization object
experience[].organization.name.cleanedstringYesOrganization name cleaned value
experience[].organization.name.raw[]arrayYesOrganization name raw snippets
experience[].organization.websitestringYesOrganization website URL
experience[].organization.linkedin_urlstringYesOrganization LinkedIn URL
experience[].organization.linkedin_idstringYesOrganization LinkedIn ID
experience[].organization.legion_idstringYesOrganization stable identifier
experience[].organization.industryenumYesOrganization industry (see Enums)
experience[].organization.sizeenumYesOrganization size (see Enums)
experience[].start_datestringYesExperience start date
experience[].end_datestringYesExperience end date
experience[].currentbooleanYesExperience current flag
experience[].tenure_monthsintegerYesJob tenure in months (calculated from start_date and end_date)
experience[].descriptionobjectYesExperience description object
experience[].description.cleanedstringYesExperience description text
experience[].description.raw[]arrayYesExperience description raw snippets

​
Education

​
Top-Level Fields

FieldTypeNullableDescription
highest_degree_levelenumYesHighest education level (see Enums)

​
Education Array

FieldTypeNullableDescription
education[]arrayNoEducation entries
education[].organizationobjectYesEducation organization object
education[].organization.name.cleanedstringYesOrganization name cleaned value
education[].organization.name.raw[]arrayYesOrganization name raw snippets
education[].organization.websitestringYesOrganization website URL
education[].organization.linkedin_urlstringYesOrganization LinkedIn URL
education[].degreeobjectYesEducation degree object
education[].degree.cleanedstringYesEducation degree cleaned value
education[].degree.raw[]arrayYesEducation degree raw snippets
education[].degree_levelenumYesDegree level (see Enums)
education[].field_of_studyobjectYesField of study object
education[].field_of_study.cleanedstringYesField of study cleaned value
education[].field_of_study.raw[]arrayYesField of study raw snippets
education[].start_datestringYesEducation start date
education[].end_datestringYesEducation end date
education[].currentbooleanYesWhether currently enrolled

​
Social & Web Presence

FieldTypeNullableDescription
socials[]arrayNoSocial profiles
socials[].networkenumNoNetwork (see Enums)
socials[].urlstringNoURL
socials[].usernamestringYesUsername
socials[].idstringYesAccount ID
socials[].currentbooleanNoIs current
socials[].num_sourcesintegerNoSource count
socials[].confidenceenumNoConfidence bucket
socials[].last_seenstringYesLast-seen date

​
Metadata

FieldTypeNullableDescription
num_sourcesintegerNoCount of contributing sources
last_seenstringYesRecord last-seen date (YYYY-MM-DD format)
build_versionstringNoSchema version identifier
current_jobs_last_confirmedstringYesDate current jobs were last confirmed
current_jobs_last_updatedstringYesDate current jobs were last updated
current_location_last_confirmedstringYesDate current location was last confirmed
current_location_last_updatedstringYesDate current location was last updated