> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fullenrich.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Dictionary

> Every data point you get from FullEnrich — across Search, Enrichment, and Reverse Email.

This is the complete list of **output** data points FullEnrich returns. Each row
is one field: its API name (dot notation relative to its parent object), type,
what it means, and an example. For the accepted **filter** values, see
[Accepted Filter Values](/api/v2/general/enums).

# 👤 People

### 🪪 Identity

| Data point | API field | Type | Description | Example |
| - | - | - | - | - |
| Full name | `full_name` | string | First and last name | `Greg Démogé` |
| First name | `first_name` | string | First name | `Greg` |
| Last name | `last_name` | string | Last name | `Démogé` |
| Headline | `headline` | string | Short professional tagline written by the person on their professional network profile | `Co-founder & CPO at FullEnrich \| B2B Data & Enrichment` |
| Description | `description` | string | Free-text summary written by the person in the about section of their professional network profile (not always present) | `Building FullEnrich to make B2B contact data reliable…` |
| City | `location.city` | string | City | `San Francisco` |
| Region / state | `location.region` | string | Region or state | `California` |
| Country | `location.country` | string | Country name | `United States` |
| Country code | `location.country_code` | string | ISO 3166-1 alpha-2 code | `US` |
| Professional network URL | `social_profiles.professional_network.url` | string | Profile URL | `https://www.linkedin.com/in/demoge` |
| Professional network handle | `social_profiles.professional_network.handle` | string | Profile handle | `demoge` |
| Professional network id | `social_profiles.professional_network.id` | integer | Numeric profile id | `583778722` |
| Professional network connections | `social_profiles.professional_network.connection_count` | integer | Network size | `500` |
| Language | `languages[].language` | string | Language spoken | `english` |
| Language proficiency | `languages[].proficiency` | string (enum) | Proficiency level | `FULL_PROFESSIONAL` |

### 📇 Verified contact info

<Info>Returned by **Enrichment** and **Reverse Email**. Email arrays contain usable results, while `phones[]` contains every phone candidate for transparency, including candidates excluded from `most_probable_phone`.</Info>

| Data point | API field | Type | Description | Example |
| - | - | - | - | - |
| Work email | `contact_info.work_emails[].email` | string | Verified professional email | `greg@fullenrich.com` |
| Work email status | `contact_info.work_emails[].status` | string (enum) | Deliverability status | `DELIVERABLE` |
| Personal email | `contact_info.personal_emails[].email` | string | Verified personal email | `greg.demoge@gmail.com` |
| Personal email status | `contact_info.personal_emails[].status` | string (enum) | Deliverability status | `DELIVERABLE` |
| Phone number | `contact_info.phones[].number` | string | Internationally formatted phone number | `+1 415 555 0132` · `+33 6 12 34 56 78` |
| Phone region | `contact_info.phones[].region` | string | ISO 3166-1 alpha-2 code of the number | `US` · `FR` |
| Line type | `contact_info.phones[].line_type` | string (enum) | Detected line type; always present | `MOBILE` · `LANDLINE` · `VOIP` · `UNKNOWN` |
| Line status | `contact_info.phones[].line_status` | string (enum) | Whether the line is active; always present | `ACTIVE` · `INACTIVE` · `UNKNOWN` |
| Ownership match | `contact_info.phones[].ownership_match` | string (enum) | US/Canada ownership verdict; omitted outside US/Canada or without a verdict | `CONFIRMED` · `MISMATCH` |
| Ownership confidence | `contact_info.phones[].ownership_match_confidence` | integer (0–100) | Confidence for a confirmed US/Canada mobile; omitted when inapplicable | `80` · `90` |
| Connect rate | `contact_info.phones[].connect_rate` | string (enum) | Pickup-probability bucket for an active US/Canada mobile without an ownership mismatch; omitted when unavailable or inapplicable | `HIGHEST` · `HIGH` · `MEDIUM` |

For each enriched contact, we return `most_probable_work_email`,
`most_probable_personal_email`, and `most_probable_phone`.
We return them only if they pass all our verification layers.

If we find multiple data points that pass our verification filters, we return
only the one we're most confident in.
If you don't get any `most_probable_x`, it means that we haven't been able to find
any data point that passes our verification layers, even if `work_emails[]`,
`phones[]`, or `personal_emails[]` are not empty. No credits will be used in this
case.

### 💼 Current & past roles

Returned under `employment.current` (single object) and `employment.all[]` (full
history). **Each field below exists per experience.**

| Data point | API field | Type | Description | Example |
| - | - | - | - | - |
| Job title | `title` | string | Job title | `Co-founder & CPO` |
| Seniority | `seniority` | string (enum) | Seniority level | `Founder` |
| Job function | `job_functions[].function` | string (enum) | Function category | `Executive & Leadership` |
| Sub-function | `job_functions[].sub_function` | string (enum) | Role within the function | `Founder/Owner` |
| Role description | `description` | string | Declarative description of the role (not always present) | `Leading product and data at FullEnrich…` |
| Company | `company` | object | Employer — full company profile, see [Company](#-company) | `FullEnrich` |
| Start date | `start_at` | string (ISO 8601) | Employment start, `YYYY-MM-DDTHH:MM:SSZ` | `2024-01-01T00:00:00Z` |
| End date | `end_at` | string (ISO 8601) | Employment end — **only for past roles** (omitted when current) | `2023-12-31T00:00:00Z` |
| Is current | `is_current` | boolean | Whether this is the current employment | `true` |

### 🎓 Education & skills

| Data point | API field | Type | Description | Example |
| - | - | - | - | - |
| School | `educations[].school_name` | string | Institution | `Stanford University` |
| Degree | `educations[].degree` | string | Degree | `MS` |
| Education start | `educations[].start_at` | string (ISO 8601) | Start date | `2015-09-01T00:00:00Z` |
| Education end | `educations[].end_at` | string (ISO 8601) | End date | `2019-06-30T00:00:00Z` |
| Skills | `skills[]` | string array | Professional declared skills | `Design Strategy, Interaction Design, Lean Startup` |

# 🏢 Company

Every person record embeds the **full company profile** for their current (and
past) employers, under `employment.current.company` / `employment.all[].company`.
Company Search and Company Lookup return the same object.

### 🏷️ Identity

| Data point | API field | Type | Description | Example |
| - | - | - | - | - |
| Company id | `id` | string (uuid) | Unique company identifier | `a1b2c3d4-e5f6-7890-abcd-ef1234567890` |
| Company name | `name` | string | Legal or brand name | `FullEnrich` |
| Domain | `domain` | string | Company domain | `fullenrich.com` |
| Website | `website` | string | Company website URL as declared by the company — may differ from `domain` (subdomain, path, tracking parameters). Not always present | `https://www.fullenrich.com` |
| Description | `description` | string | Company description | `Waterfall enrichment across 20+ vendors to find verified emails and phone numbers.` |
| Logo URL | `logo_url` | string | Company logo hosted by FullEnrich, built from the professional network handle | `https://app.fullenrich.com/logo/company/handle/fullenrich` |
| Professional network id | `social_profiles.professional_network.id` | integer | Numeric company id | `98444201` |
| Professional network handle | `social_profiles.professional_network.handle` | string | Company page handle | `fullenrich` |
| Professional network URL | `social_profiles.professional_network.url` | string | Company page URL | `https://www.linkedin.com/company/fullenrich` |
| Professional network followers | `social_profiles.professional_network.connection_count` | integer | Followers count | `24507` |

### 📊 Firmographics

| Data point | API field | Type | Description | Example |
| - | - | - | - | - |
| Industry | `industry.main_industry` | string (enum) | Primary industry (standard industry taxonomy, 200+ values) | `Software Development` |
| Specialties | `specialties[]` | string array | Declarative tags and focus areas | `B2B data, Email & phone finder` |
| Company type | `company_type` | string (enum) | Public, private, nonprofit… | `Privately Held` |
| Headcount | `headcount` | integer | Exact employee count (may be `0` even when a range is known) | `65` |
| Headcount range | `headcount_range` | string (enum) | Size bracket | `11-50` |
| Year founded | `year_founded` | integer | Founding year (`0` when unknown) | `2023` |

### 📍 Location

| Data point | API field | Type | Description | Example |
| - | - | - | - | - |
| HQ street | `locations.headquarters.line1` | string | Street address | `1885 Mission St` |
| HQ address line 2 | `locations.headquarters.line2` | string | Full location string | `San Francisco, California 94103, US` |
| HQ city | `locations.headquarters.city` | string | City | `San Francisco` |
| HQ region | `locations.headquarters.region` | string | State or region | `California` |
| HQ country | `locations.headquarters.country` | string | Country name | `United States` |
| HQ country code | `locations.headquarters.country_code` | string | ISO 3166-1 alpha-2 code | `US` |
| Offices | `locations.offices[].{line1, line2}` | array | Additional offices — **raw address lines only** (no parsed city/region); can be `null` or empty | `111 8th Ave` · `New York, NY 10011, US` |

# Accepted values

Enum value lists are maintained in one place — they are not duplicated here:

| Field | Source of truth |
| - | - |
| Seniority, Job function & sub-function, Company industry, Company type | [Accepted Filter Values](/api/v2/general/enums) |
| Email status (`work/personal email status`) | [Email Verification Status](/api/v2/general/email-status) |

Two short sets that have no dedicated page:

* **Headcount range:** `1-10` · `11-50` · `51-200` · `201-500` · `501-1000` · `1001-5000` · `5001-10000` · `10001+`
* **Language proficiency:** `NATIVE_OR_BILINGUAL` · `FULL_PROFESSIONAL` · `PROFESSIONAL_WORKING` · `LIMITED_WORKING` · `ELEMENTARY`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.