---
title: "People Enrichment"
method: POST
path: "/people/match"
tags: ["Enrichment"]
---

# People Enrichment

`POST /people/match`

This endpoint consumes **1-9 Apollo credits per person** when credit-consuming data is found: **1 credit** for demographics/email, plus **8 credits** if a mobile phone is returned. If Apollo doesn't return credit-consuming data, the request consumes **0 credits**.

If you use waterfall enrichment for phone or email, credit usage depends on the returned data and the vendors included in your [waterfall enrichment configuration](https://knowledge.apollo.io/hc/en-us/articles/34071121664781-Use-Waterfall-Enrichment). Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

<a href="https://knowledge.apollo.io/hc/en-us/articles/33699917233293-Enrichment-Overview" target="_blank">Enrichment</a> is when you refresh existing records so your prospecting data is up-to-date.<br><br>Use the People Enrichment endpoint to enrich data for one person. To enrich data for up to ten people with a single API call, use the <a href="https://docs.apollo.io/reference/bulk-people-enrichment">Bulk People Enrichment endpoint</a> instead.<br><br>Apollo relies on the information you pass via the endpoint's parameters to identify the correct person to enrich. If you provide more information about a person, Apollo is more likely to find a match within its database. If you only provide general information, such as a name without a domain or email address, you might receive a `200` response, but the response indicates that no records have been enriched.<br><br>By default, this endpoint doesn't return personal emails or phone numbers. Use the `reveal_personal_emails` and `reveal_phone_number` parameters to retrieve emails and phone numbers.<br><br>When you use `reveal_phone_number`, a valid `webhook_url` is required so Apollo can deliver the completed phone enrichment results. Apollo returns the main enrichment response synchronously, then sends the requested phone numbers to the webhook asynchronously. [See webhook details](#webhook-details).<br><br>You can also use the `run_waterfall_email` and `run_waterfall_phone` parameters to run waterfall enrichment via this endpoint. [Waterfall enrichment](https://knowledge.apollo.io/hc/en-us/articles/34071089002509-Waterfall-Enrichment-Overview) gives you broader data coverage by checking connected third-party data sources for contact emails and phone numbers.<br><br>When you call this endpoint and include at least one waterfall parameter, a valid `webhook_url` is required so Apollo can deliver the completed waterfall enrichment results. Apollo returns an immediate synchronous response with demographic and firmographic data, along with a waterfall enrichment request status. Apollo then delivers enriched emails or phone numbers asynchronously to the configured webhook.

### Webhook Details

- When using Apollo enrichment for phone number reveal, the webhook response follows: [Native webhook response details](https://docs.apollo.io/docs/retrieve-mobile-phone-numbers-for-contacts#webhook-response-details).

- When using waterfall enrichment, the webhook response follows: [Waterfall webhook response details](https://docs.apollo.io/docs/enrich-phone-and-email-using-data-waterfall#response-details).

- You can poll webhook results with the [poll webhook result](https://docs.apollo.io/docs/poll-webhook-result) endpoint by passing <code>request_id</code>.

### Webhook Requirements

- **HTTPS Required:** Your endpoint must be publicly accessible over HTTPS.

- **Rate Limiting:** Ensure your webhook endpoint can handle the volume of webhook traffic sent by Apollo.

- **Idempotency:** Apollo may retry webhook calls; your endpoint should be idempotent to handle duplicate payloads safely.

## Query parameters

- `first_name` string
- `last_name` string
- `name` string
- `email` string
- `hashed_email` string
- `organization_name` string
- `domain` string
- `id` string
- `linkedin_url` string
- `run_waterfall_email` boolean
- `run_waterfall_phone` boolean
- `reveal_personal_emails` boolean
- `reveal_phone_number` boolean
- `webhook_url` string

## Response `200`

200

- object
  - `request_id` integer — The request ID for the enrichment request. Save this ID to map this request with the corresponding webhook result.
  - `person` object
    - `id` string
    - `first_name` string
    - `last_name` string
    - `name` string
    - `linkedin_url` string
    - `title` string
    - `email_status` string
    - `photo_url` string
    - `twitter_url` unknown
    - `github_url` unknown
    - `facebook_url` unknown
    - `extrapolated_email_confidence` number, nullable
    - `headline` string
    - `email` string
    - `organization_id` string
    - `employment_history` object[]
      - `_id` string
      - `created_at` unknown
      - `current` boolean
      - `degree` unknown
      - `description` unknown
      - `emails` unknown
      - `end_date` unknown
      - `grade_level` unknown
      - `kind` unknown
      - `major` unknown
      - `organization_id` string
      - `organization_name` string
      - `raw_address` unknown
      - `start_date` string
      - `title` string
      - `updated_at` unknown
      - `id` string
      - `key` string
    - `state` string
    - `city` string
    - `country` string
    - `contact_id` string
    - `contact` object
      - `contact_roles` unknown[]
        - unknown
      - `id` string
      - `first_name` string
      - `last_name` string
      - `name` string
      - `linkedin_url` string
      - `title` string
      - `contact_stage_id` string
      - `owner_id` unknown
      - `creator_id` string
      - `person_id` string
      - `email_needs_tickling` unknown
      - `organization_name` string
      - `source` string
      - `original_source` string
      - `organization_id` string
      - `headline` string
      - `photo_url` unknown
      - `present_raw_address` string
      - `linkedin_uid` unknown
      - `extrapolated_email_confidence` number, nullable
      - `salesforce_id` unknown
      - `salesforce_lead_id` unknown
      - `salesforce_contact_id` unknown
      - `salesforce_account_id` unknown
      - `crm_owner_id` unknown
      - `created_at` string
      - `emailer_campaign_ids` unknown[]
        - unknown
      - `direct_dial_status` unknown
      - `direct_dial_enrichment_failed_at` unknown
      - `email_status` string
      - `email_source` unknown
      - `account_id` string
      - `last_activity_date` unknown
      - `hubspot_vid` unknown
      - `hubspot_company_id` unknown
      - `crm_id` unknown
      - `sanitized_phone` string
      - `merged_crm_ids` unknown
      - `updated_at` string
      - `queued_for_crm_push` unknown
      - `suggested_from_rule_engine_config_id` unknown
      - `email_unsubscribed` unknown
      - `label_ids` unknown[]
        - unknown
      - `has_pending_email_arcgate_request` boolean
      - `has_email_arcgate_request` boolean
      - `existence_level` string
      - `email` string
      - `email_from_customer` boolean
      - `typed_custom_fields` object
      - `custom_field_errors` unknown
      - `crm_record_url` unknown
      - `email_status_unavailable_reason` unknown
      - `email_true_status` string
      - `updated_email_true_status` boolean
      - `contact_rule_config_statuses` unknown[]
        - unknown
      - `source_display_name` string
      - `contact_emails` object[]
        - `email` string
        - `email_md5` string
        - `email_sha256` string
        - `email_status` string
        - `email_source` unknown
        - `extrapolated_email_confidence` number, nullable
        - `position` integer
        - `email_from_customer` unknown
        - `free_domain` boolean
      - `time_zone` string
      - `phone_numbers` object[]
        - `raw_number` string
        - `sanitized_number` string
        - `type` unknown
        - `position` integer
        - `status` string
        - `dnc_status` unknown
        - `dnc_other_info` unknown
        - `dialer_flags` unknown
      - `account_phone_note` unknown
      - `free_domain` boolean
      - `is_likely_to_engage` boolean
    - `revealed_for_current_team` boolean
    - `organization` object
      - `id` string
      - `name` string
      - `website_url` string
      - `blog_url` unknown
      - `angellist_url` unknown
      - `linkedin_url` string
      - `twitter_url` string
      - `facebook_url` string
      - `primary_phone` object
      - `languages` unknown[]
        - unknown
      - `alexa_ranking` integer
      - `phone` unknown
      - `linkedin_uid` string
      - `founded_year` integer
      - `publicly_traded_symbol` unknown
      - `publicly_traded_exchange` unknown
      - `logo_url` string
      - `crunchbase_url` unknown
      - `primary_domain` string
      - `industry` string
      - `keywords` string[]
      - `estimated_num_employees` integer
      - `industries` string[]
      - `secondary_industries` unknown[]
        - unknown
      - `snippets_loaded` boolean
      - `industry_tag_id` string
      - `industry_tag_hash` object
        - `information technology & services` string
      - `retail_location_count` integer
      - `raw_address` string
      - `street_address` string
      - `city` string
      - `state` string
      - `postal_code` string
      - `country` string
      - `owned_by_organization_id` unknown
      - `seo_description` string
      - `short_description` string
      - `suborganizations` unknown[]
        - unknown
      - `num_suborganizations` integer
      - `annual_revenue_printed` string
      - `annual_revenue` integer
      - `total_funding` integer
      - `total_funding_printed` string
      - `latest_funding_round_date` string
      - `latest_funding_stage` string
      - `funding_events` object[]
        - `id` string
        - `date` string
        - `news_url` unknown
        - `type` string
        - `investors` string
        - `amount` string
        - `currency` string
      - `technology_names` string[]
      - `current_technologies` object[]
        - `uid` string
        - `name` string
        - `category` string
      - `org_chart_root_people_ids` string[]
      - `org_chart_sector` string
      - `org_chart_removed` boolean
      - `org_chart_show_department_filter` boolean
    - `is_likely_to_engage` boolean
    - `intent_strength` unknown
    - `show_intent` boolean
    - `departments` string[]
    - `subdepartments` string[]
    - `functions` string[]
    - `seniority` string

## Other responses

- `401` — 401
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)