> ## Documentation Index > Fetch the complete documentation index at: https://www.datalegion.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Field Reference > Complete reference for all fields in the Data Legion person data schema, organized by category: identity, employment, contact, location, experience, education, and socials. Complete reference for all fields in the person data schema, organized by category. ## Core Identity | Field | Type | Nullable | Description | | ---------------- | ------ | -------- | ------------------------------------ | | `legion_id` | string | No | Stable contact identifier | | `full_name` | string | No | Best-available full name | | `first_name` | string | No | First name | | `middle_name` | string | Yes | Middle name (non-initial) | | `middle_initial` | string | Yes | Middle initial (provided or derived) | | `last_name` | string | No | Last name | | `last_initial` | string | No | Last name initial | | `suffix` | string | Yes | Name suffix | | `prefix` | string | Yes | Name prefix | | `sex` | enum | Yes | Sex value (see [Enums](/docs/enums#sex)) | ## Birth & Age | Field | Type | Nullable | Description | | ------------- | ------- | -------- | ------------------------------------------------- | | `birth_date` | string | Yes | Birth date (precision preserved, ISO 8601 format) | | `birth_year` | integer | Yes | Birth year | | `birth_month` | integer | Yes | Birth month | | `birth_day` | integer | Yes | Birth day | | `age` | integer | Yes | Derived age | ## Current Employment | Field | Type | Nullable | Description | | ---------------------- | ------- | -------- | ------------------------------------------------------------------ | | `job_title` | string | Yes | Current job title (derived from experience) | | `company_name` | string | Yes | Current company name (derived from experience) | | `company_domain` | string | Yes | Current company domain (derived from experience) | | `company_industry` | enum | Yes | Current company industry (see [Enums](/docs/enums#company-industry)) | | `company_size` | enum | Yes | Current company size (see [Enums](/docs/enums#company-size)) | | `company_legion_id` | string | Yes | Current company stable identifier | | `company_linkedin_url` | string | Yes | Current company LinkedIn URL | | `company_linkedin_id` | string | Yes | Current company LinkedIn ID | | `seniority_level` | enum | Yes | Seniority level (see [Enums](/docs/enums#seniority-level)) | | `job_function` | enum | Yes | Job function (see [Enums](/docs/enums#job-function)) | | `expense_category` | enum | Yes | P\&L expense category (see [Enums](/docs/enums#expense-category)) | | `is_decision_maker` | boolean | Yes | True if seniority is c\_level/owner/partner/vp/director | | `is_platform_worker` | boolean | Yes | True if person uses the platform rather than works for the company | | `years_of_experience` | integer | Yes | Years since earliest job start date | | `avg_tenure_months` | number | Yes | Average job tenure in months across all experience entries | ## Contact Information ### Top-Level Fields | Field | Type | Nullable | Description | | -------------- | ------ | -------- | ----------------------------------------------- | | `work_email` | string | Yes | Current work email (professional, current=true) | | `mobile_phone` | string | Yes | Current mobile phone (mobile, current=true) | ### Phones Array | Field | Type | Nullable | Description | | ---------------------- | ------- | -------- | -------------------------------------------------------------------------- | | `phones[]` | array | No | Array of phone objects | | `phones[].type` | enum | No | Phone type (see [Enums](/docs/enums#phone-type)) | | `phones[].number` | string | No | Phone number (E.164 format) | | `phones[].current` | boolean | No | Phone flagged current | | `phones[].last_seen` | string | Yes | Phone last-seen date | | `phones[].num_sources` | integer | No | Number of sources that contributed to this phone | | `phones[].confidence` | enum | No | Phone quality score (see [Quality Scoring](/docs/data-quality/quality-scoring)) | ### Emails Array | Field | Type | Nullable | Description | | ---------------------------- | ------------ | -------- | -------------------------------------------------------------------------- | | `emails[]` | array | No | Array of email objects | | `emails[].address` | string | No | Email address | | `emails[].type` | enum | Yes | Email type (see [Enums](/docs/enums#email-type)) | | `emails[].current` | boolean/null | Yes | Current status (null for personal emails) | | `emails[].last_seen` | string | Yes | Email last-seen date | | `emails[].validated` | boolean | No | Email validated | | `emails[].validation_status` | enum | Yes | Validation status (see [Enums](/docs/enums#email-validation-status)) | | `emails[].num_sources` | integer | No | Number of sources that contributed to this email | | `emails[].confidence` | enum | No | Email quality score (see [Quality Scoring](/docs/data-quality/quality-scoring)) | | `emails[].hash_sha256` | string | Yes | SHA-256 hash of email address | | `emails[].hash_sha1` | string | Yes | SHA-1 hash of email address | | `emails[].hash_md5` | string | Yes | MD5 hash of email address | ## Location ### Top-Level Fields | Field | Type | Nullable | Description | | -------------- | ------ | -------- | -------------------------------------------------- | | `city` | string | Yes | Current city (from current location) | | `state` | string | Yes | Current state/province (from current location) | | `state_code` | string | Yes | Current state ISO 3166-2 code (e.g., US-CA) | | `country` | string | Yes | Current country (from current location) | | `country_code` | string | Yes | Current country ISO 3166-1 alpha-2 code (e.g., US) | ### Locations Array | Field | Type | Nullable | Description | | ---------------------------- | ------- | -------- | --------------------------------------------------- | | `locations[]` | array | No | Array of location objects | | `locations[].street_address` | string | Yes | Street address | | `locations[].address_line_2` | string | Yes | Address line 2 | | `locations[].city` | string | Yes | City name | | `locations[].state` | string | Yes | State/province name (lowercase) | | `locations[].state_code` | string | Yes | ISO 3166-2 code (e.g., US-NY) | | `locations[].country` | string | Yes | Country name (lowercase) | | `locations[].country_code` | string | Yes | ISO 3166-1 alpha-2 code (e.g., US) | | `locations[].continent` | string | Yes | Continent name | | `locations[].continent_code` | string | Yes | Continent code | | `locations[].postal_code` | string | Yes | Postal code | | `locations[].postal_code_4` | string | Yes | ZIP+4 extension (US) | | `locations[].geo` | string | Yes | Latitude,longitude pair | | `locations[].raw[]` | array | No | Raw location from the source | | `locations[].current` | boolean | No | Location flagged current | | `locations[].num_sources` | integer | No | Number of sources that contributed to this location | | `locations[].confidence` | enum | Yes | Location quality score | | `locations[].last_seen` | string | Yes | Location last-seen date | ## LinkedIn Profile | Field | Type | Nullable | Description | | ---------------------- | ------- | -------- | ------------------------------------------- | | `linkedin_url` | string | Yes | Primary LinkedIn profile URL (current=true) | | `linkedin_id` | string | Yes | LinkedIn numeric ID | | `linkedin_followers` | integer | Yes | LinkedIn follower count | | `linkedin_connections` | integer | Yes | LinkedIn connection count | ## Skills & Languages ### Skills Array | Field | Type | Nullable | Description | | ------------------ | ------ | -------- | ------------------------ | | `skills[]` | array | No | Array of skills objects | | `skills[].cleaned` | string | Yes | Skills text (normalized) | | `skills[].raw[]` | array | No | Skills raw snippets | ### Languages Array | Field | Type | Nullable | Description | | ------------------------- | ------ | -------- | --------------------------- | | `languages[]` | array | No | Array of languages objects | | `languages[].cleaned` | string | Yes | Languages text (normalized) | | `languages[].raw[]` | array | No | Languages raw snippets | | `languages[].proficiency` | enum | Yes | Languages proficiency level | ## Professional Summary | Field | Type | Nullable | Description | | ------------------ | ------ | -------- | ------------------------------------------------ | | `headline` | object | No | Object containing headline text and raw snippets | | `headline.cleaned` | string | Yes | Headline text (normalized) | | `headline.raw[]` | array | No | Headline raw snippets | | `summary` | object | Yes | Object containing summary text and raw snippets | | `summary.cleaned` | string | Yes | Summary text (normalized) | | `summary.raw[]` | array | No | Summary raw snippets | ## Work Experience **Rich job history**: Career progression with experience arrays, job transitions, tenure tracking, and career context, not just current role. | Field | Type | Nullable | Description | | ---------------------------------------- | ------- | -------- | ------------------------------------------------------------------ | | `experience[]` | array | No | Experience entries (ordered by current status and date) | | `experience[].title` | object | Yes | Experience title object | | `experience[].title.cleaned` | string | Yes | Experience title cleaned value | | `experience[].title.raw[]` | array | Yes | Experience title raw snippets | | `experience[].seniority_level` | enum | Yes | Seniority level classification | | `experience[].job_function` | enum | Yes | Job function classification | | `experience[].expense_category` | enum | Yes | P\&L expense category | | `experience[].is_decision_maker` | boolean | Yes | True if seniority is c\_level/owner/partner/vp/director | | `experience[].is_platform_worker` | boolean | Yes | True if person uses the platform rather than works for the company | | `experience[].organization` | object | Yes | Experience organization object | | `experience[].organization.name.cleaned` | string | Yes | Organization name cleaned value | | `experience[].organization.name.raw[]` | array | Yes | Organization name raw snippets | | `experience[].organization.website` | string | Yes | Organization website URL | | `experience[].organization.linkedin_url` | string | Yes | Organization LinkedIn URL | | `experience[].organization.linkedin_id` | string | Yes | Organization LinkedIn ID | | `experience[].organization.legion_id` | string | Yes | Organization stable identifier | | `experience[].organization.industry` | enum | Yes | Organization industry (see [Enums](/docs/enums#company-industry)) | | `experience[].organization.size` | enum | Yes | Organization size (see [Enums](/docs/enums#company-size)) | | `experience[].start_date` | string | Yes | Experience start date | | `experience[].end_date` | string | Yes | Experience end date | | `experience[].current` | boolean | Yes | Experience current flag | | `experience[].tenure_months` | integer | Yes | Job tenure in months (calculated from start\_date and end\_date) | | `experience[].description` | object | Yes | Experience description object | | `experience[].description.cleaned` | string | Yes | Experience description text | | `experience[].description.raw[]` | array | Yes | Experience description raw snippets | ## Education ### Top-Level Fields | Field | Type | Nullable | Description | | ---------------------- | ---- | -------- | ---------------------------------------------------------- | | `highest_degree_level` | enum | Yes | Highest education level (see [Enums](/docs/enums#degree-level)) | ### Education Array | Field | Type | Nullable | Description | | --------------------------------------- | ------- | -------- | ----------------------------------------------- | | `education[]` | array | No | Education entries | | `education[].organization` | object | Yes | Education organization object | | `education[].organization.name.cleaned` | string | Yes | Organization name cleaned value | | `education[].organization.name.raw[]` | array | Yes | Organization name raw snippets | | `education[].organization.website` | string | Yes | Organization website URL | | `education[].organization.linkedin_url` | string | Yes | Organization LinkedIn URL | | `education[].degree` | object | Yes | Education degree object | | `education[].degree.cleaned` | string | Yes | Education degree cleaned value | | `education[].degree.raw[]` | array | Yes | Education degree raw snippets | | `education[].degree_level` | enum | Yes | Degree level (see [Enums](/docs/enums#degree-level)) | | `education[].field_of_study` | object | Yes | Field of study object | | `education[].field_of_study.cleaned` | string | Yes | Field of study cleaned value | | `education[].field_of_study.raw[]` | array | Yes | Field of study raw snippets | | `education[].start_date` | string | Yes | Education start date | | `education[].end_date` | string | Yes | Education end date | | `education[].current` | boolean | Yes | Whether currently enrolled | ## Certifications Professional certifications, licenses, and credentials. Each entry includes the certification name, issuing institution, and optional credential ID and dates. | Field | Type | Nullable | Description | | -------------------------------------- | ------ | -------- | -------------------------------- | | `certifications[]` | array | No | Array of certification objects | | `certifications[].name.cleaned` | string | Yes | Normalized certification name | | `certifications[].name.raw[]` | array | No | Raw certification name variants | | `certifications[].institution.cleaned` | string | Yes | Normalized issuing institution | | `certifications[].institution.raw[]` | array | No | Raw issuing institution variants | | `certifications[].credential_id` | string | Yes | Credential ID | | `certifications[].issue_date` | string | Yes | Issue date | | `certifications[].expiration_date` | string | Yes | Expiration date | ## Social & Web Presence | Field | Type | Nullable | Description | | ----------------------- | ------- | -------- | -------------------------------------------- | | `socials[]` | array | No | Social profiles | | `socials[].network` | enum | No | Network (see [Enums](/docs/enums#social-network)) | | `socials[].url` | string | No | URL | | `socials[].username` | string | Yes | Username | | `socials[].id` | string | Yes | Account ID | | `socials[].current` | boolean | No | Is current | | `socials[].num_sources` | integer | No | Source count | | `socials[].confidence` | enum | No | Confidence bucket | | `socials[].last_seen` | string | Yes | Last-seen date | ## Metadata | Field | Type | Nullable | Description | | --------------------------------- | ------- | -------- | ----------------------------------------- | | `num_sources` | integer | No | Count of contributing sources | | `last_seen` | string | Yes | Record last-seen date (YYYY-MM-DD format) | | `build_version` | string | No | Schema version identifier | | `current_jobs_last_confirmed` | string | Yes | Date current jobs were last confirmed | | `current_jobs_last_updated` | string | Yes | Date current jobs were last updated | | `current_location_last_confirmed` | string | Yes | Date current location was last confirmed | | `current_location_last_updated` | string | Yes | Date current location was last updated | ## Related Documentation * **[Schema Example](/docs/person-data/schema)** - See a complete example record * **[Data Tiers](/docs/person-data/tiers)** - Base vs premium field availability * **[Dataset Statistics](/docs/person-data/stats)** - Coverage statistics and field fill rates * **[Enum Values](/docs/enums)** - All possible enum values * **[Data Quality](/docs/data-quality/overview)** - Understanding quality scores