Bulk People Enrichment API (POST /api/v1/people/bulk_match)
A Apollo dataset with 91 fields. View the Apollo profile.
Product details
| Match keys | matches[].id |
|---|---|
| Geo coverage | Global |
| Refresh cadence | On-demand |
| Lifecycle | Active |
| Pricing model | Per-record |
| Last verified | 2026-08-07 |
Bulk People Enrichment API (POST /api/v1/people/bulk_match) fields
| Field | API name | Category | Type | Fill rate | Description |
|---|---|---|---|---|---|
| Last Name | last_name | String | - | Contact last name. | |
| Work Email Address | String | - | Work email address of the contact; core outreach field. | ||
| Job Function | functions | Array of Strings | - | Standardized job function name. | |
| Job Title | title | String | - | Job title at current place of employment. | |
| Department | departments | Array of Strings | - | Department the function maps to. | |
| Management Level | seniority | String | - | Seniority band(s) of the contact. | |
| Company Website | organization.website_url | URL (String) | - | Website of the prior company. | |
| Area of Study | employment_history[].major | String | - | Major/field of study. | |
| Educational Degree | employment_history[].degree | String | - | Degree type earned. | |
| Work City | city | String | - | City of the contact's work address. | |
| Work Country | country | String | - | Country of the contact's work address. | |
| HQ State | organization.state | String | - | State/province of the company's primary address. | |
| HQ Zip Code | organization.postal_code | String | - | Zip/postal code of the company's primary address. | |
| HQ Country | organization.country | String | - | Country of the company's primary address. | |
| Company Languages | organization.languages | Array of Strings | - | Languages associated with the company (e.g. spoken/supported languages). | |
| Email Deliverability Status | email_status | String | - | Deliverability status of the enriched email. | |
| First Name | first_name | String | - | Contact first name. | |
| Facebook URL | organization.facebook_url | URL (String) | - | URL of the person's or company's Facebook profile. | |
| Company Secondary Industries | organization.secondary_industries | Array of Strings | - | Secondary (non-primary) industry categories associated with the company. | |
| Revealed For Current Team Flag | revealed_for_current_team | Boolean | - | Flag indicating whether this person record has been revealed (contact details unlocked) for the current API caller's team. | |
| Waterfall Status Message | waterfall.message | String | - | Human-readable explanation of the waterfall enrichment request's status. | |
| Company Industries (All) | organization.industries | Array of Strings | - | Full list of ALL industry categories that apply to the company (as opposed to just its single primary industry). | |
| Person Employer Organization Object | organization | Object | - | PARENT: the employer company's full firmographic record, embedded within a person enrichment response. | |
| HQ Street Address | organization.street_address | String | - | Street-only portion of the company's primary address (no city/state/zip). | |
| Likely to Engage Flag | is_likely_to_engage | Boolean | - | Flag indicating the person is predicted to be responsive/likely to engage with outreach. | |
| Company Logo URL | organization.logo_url | URL (String) | - | URL of the company's logo image. | |
| Employment History Organization ID | employment_history[].organization_id | String | - | Vendor-internal ID of the employer company referenced within a person's employment history entry. | |
| Company Phone Number | organization.phone | String | - | Company's main phone number. | |
| Work State/Region | state | String | - | State/province of the contact's work address. | |
| Twitter URL | twitter_url | URL (String) | - | URL of the person's or company's Twitter/X profile. | |
| Person Photo URL | photo_url | URL (String) | - | URL of the person's profile photo. | |
| Intent Strength | intent_strength | Number (Decimal) | - | Strength/magnitude of a person's buying-intent signal. | |
| Facebook URL | facebook_url | URL (String) | - | URL of the person's or company's Facebook profile. | |
| Twitter URL | organization.twitter_url | URL (String) | - | URL of the person's or company's Twitter/X profile. | |
| Employment History Record Created Date | employment_history[].created_at | String | - | Timestamp when a person's employment/education history entry record was created in the vendor's system (vendor record metadata, not the actual start/end date of the role). | |
| Employment History Role Description | employment_history[].description | String | - | Free-text description of duties/responsibilities during a prior role. | |
| Year Founded | organization.founded_year | Number (Integer) | - | Year the company was founded. | |
| Publicly Traded Symbol | organization.publicly_traded_symbol | String | - | Ticker symbol under which the company trades on a public stock exchange. | |
| GitHub URL | github_url | URL (String) | - | URL of the person's GitHub profile. | |
| Bulk Enrichment Credits Consumed | credits_consumed | Number (Decimal) | - | Total credits consumed by a bulk enrichment request; can be fractional. | |
| Phone Enrichment Status Message | phone_enrichment.message | String | - | Human-readable explanation of the phone enrichment job's status. | |
| Enrichment Request ID | request_id | Number (Integer) | - | Vendor-issued ID for tracking a specific enrichment API request (used to correlate async webhook results). | |
| Waterfall Request Status | waterfall.status | String | - | Whether a waterfall enrichment request was accepted for asynchronous processing. | |
| Company Name | employment_history[].organization_name | String | - | Company name. | |
| Full Name | name | String | - | Full name (or full display name) of a person, contact, executive, officer, or social-media account. Entity-differentiated: Contact, Executive, Officer/Director, Person, Social Profile, Social Post (tagged account). | |
| Employee Count | organization.estimated_num_employees | Number (Integer) | - | Employee count of the contact's company. | |
| Company LinkedIn UID | organization.linkedin_uid | String | - | Vendor-internal numeric ID for the company's LinkedIn page (distinct from the LinkedIn profile URL). | |
| Enrichment Error Code | error_code | String | - | Machine-readable error code, populated only on failed enrichment responses. | |
| Employment History End Date | employment_history[].end_date | String | - | End date of a prior/historical role. | |
| Employment History Start Date | employment_history[].start_date | String | - | Start date of a prior/historical role. | |
| Employment History Job Title | employment_history[].title | String | - | Job title held during a prior/historical role (distinct from current job title). | |
| Company Keywords | organization.keywords | Array of Strings | - | Free-text marketing keywords/tags describing the company's business. | |
| Primary Industry Name | organization.industry | String | - | Name of the entry. | |
| LinkedIn URL | linkedin_url | URL (String) | - | URL of the person's or company's LinkedIn profile. | |
| LinkedIn URL | organization.linkedin_url | URL (String) | - | URL of the person's or company's LinkedIn profile. | |
| Apollo Person ID | id | String | - | Apollo's internal unique identifier for the person record. | |
| Apollo Organization ID | organization.id | String | - | Apollo's internal unique identifier for the organization record. | |
| Apollo Organization ID | organization_id | String | - | Apollo's internal unique identifier for the organization record. | |
| Extrapolated Email Confidence Score | extrapolated_email_confidence | Number (Decimal) | - | Confidence score for an email address that was extrapolated/inferred rather than directly observed. | |
| Person Headline | headline | String | - | Short professional tagline for the person (e.g. "Founder & CEO at Apollo"), distinct from their job title. | |
| Employment History Current Flag | employment_history[].current | Boolean | - | Flag indicating whether a role in a person's employment/education history is their current one. | |
| Employment History Record ID | employment_history[].id | String | - | Vendor-internal unique ID of a person's employment/education history entry. | |
| Show Intent Flag | show_intent | Boolean | - | Flag indicating whether buying-intent data should be shown/is available for this person. | |
| Subdepartment | subdepartments | Array of Strings | - | More granular sub-classification beneath a person's department (e.g. "executive", "founder" under the "c_suite" department). | |
| Alexa Ranking | organization.alexa_ranking | Number (Integer) | - | Alexa web traffic ranking of the company's website (lower is more trafficked). | |
| Employment History Raw Address | employment_history[].raw_address | String | - | Unstructured/raw address text captured for a person's employment history entry (not standardized into components). | |
| Company AngelList URL | organization.angellist_url | URL (String) | - | URL of the company's AngelList profile. | |
| Company Blog URL | organization.blog_url | URL (String) | - | URL of the company's blog. | |
| Company Primary Phone Object | organization.primary_phone | Object | - | PARENT: object holding the company's primary phone number and associated metadata. | |
| Publicly Traded Exchange | organization.publicly_traded_exchange | String | - | Stock exchange on which the company is publicly traded. | |
| Company Crunchbase URL | organization.crunchbase_url | URL (String) | - | URL of the company's Crunchbase profile. | |
| Company Primary Domain | organization.primary_domain | String | - | The bare domain of the company's website (e.g. "apollo.io"), distinct from the full website URL. | |
| Company Primary Industry Tag ID | organization.industry_tag_id | String | - | Vendor-internal ID tag for the company's primary industry classification (distinct from the human-readable industry name). | |
| Company Industry Tag Hash Object | organization.industry_tag_hash | Object | - | PARENT: lookup map of industry name to its vendor-internal tag ID, for the company's industries. | |
| Retail Location Count | organization.retail_location_count | Number (Integer) | - | Number of retail/physical locations the company operates. | |
| Company Snippets Loaded Flag | organization.snippets_loaded | Boolean | - | Flag indicating whether the vendor has finished loading supplementary company snippet/summary data for this record (vendor processing-status metadata, not a fact about the company itself). | |
| HQ Raw Address (Full String) | organization.raw_address | String | - | Full single-string formatted address of the company's primary location (street, city, state, zip, country combined), as opposed to individually-parsed address component fields. | |
| Bulk Enrichment Matches Object | matches | Array of Objects | - | PARENT: array of enriched person records returned by a bulk enrichment request. | |
| Enrichment Response Status | status | String | - | Success/failure status of the enrichment API call itself (not whether any person was matched). | |
| Bulk Enrichment Unique Enriched Records Count | unique_enriched_records | Number (Integer) | - | The number of distinct records that consumed credits on a bulk enrichment request; a billing count, not a match count. | |
| Enrichment Error Message | error_message | String | - | Human-readable error message, populated only on failed enrichment responses. | |
| Phone Enrichment Status | phone_enrichment.status | String | - | Status of an asynchronous phone enrichment job (e.g. pending, skipped). | |
| Phone Enrichment Status Object | phone_enrichment | Object | - | PARENT: status of an asynchronous native phone-number enrichment job, whose results are delivered later via webhook. | |
| Bulk Enrichment Missing Records Count | missing_records | Number (Integer) | - | The number of submitted records a bulk enrichment request could not match to a database record. | |
| Phone Enrichment Job ID | phone_enrichment.request_id | String | - | Vendor-issued identifier for an asynchronous phone enrichment job; distinct from the top-level enrichment request_id. | |
| Bulk Enrichment Total Requested | total_requested_enrichments | Number (Integer) | - | The number of records submitted in a bulk enrichment request's details[] array. | |
| Waterfall Unprocessed Attributes | waterfall.unprocessed_attributes | Array of Objects | - | List of submitted attributes that could not be queued for waterfall enrichment; present only on partial failures. | |
| Waterfall Enrichment Request Object | waterfall | Object | - | PARENT: status of an asynchronous waterfall email/phone enrichment request, whose results are delivered later via webhook. | |
| HQ City | organization.city | String | - | City of the company's primary address. | |
| Employment History Object | employment_history | Array of Objects | - | Prior roles: title, management level, from/to dates, and company (id, name, phone, website). | |
| Company Name | organization.name | String | - | Company name. |
More from Apollo
- Bulk Organization Enrichment API (POST /api/v1/organizations/bulk_enrich)
- Organization Enrichment API (GET /api/v1/organizations/enrich)
- People Enrichment API (POST /api/v1/people/match)
- People API Search (POST /api/v1/mixed_people/api_search)
Bulk People Enrichment API (POST /api/v1/people/bulk_match) FAQ
What fields are in Bulk People Enrichment API (POST /api/v1/people/bulk_match)?
Bulk People Enrichment API (POST /api/v1/people/bulk_match) from Apollo has 91 fields, including Last Name, Work Email Address and Job Function.
What do I need to match against Bulk People Enrichment API (POST /api/v1/people/bulk_match)?
Bulk People Enrichment API (POST /api/v1/people/bulk_match) matches on matches[].id.
How is Bulk People Enrichment API (POST /api/v1/people/bulk_match) priced?
Per-record. Request a quote or a sample on SpringDB.