Use the Bulk People Enrichment endpoint to enrich data for up to 10 people with a single API call. To enrich data for only 1 person, use the People Enrichment endpoint instead.

Apollo relies on the information you pass via the endpoint's parameters to identify the correct people to enrich. When you provide more information, Apollo is more likely to find matches 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 will indicate that no records have been enriched. The details for each person should be passed as an object with the details[] array.

By default, this endpoint does not return personal emails or phone numbers. Use the reveal_personal_emails and reveal_phone_number parameters to retrieve emails and phone numbers. If you set either of these parameters to true, Apollo will attempt to provide emails or phone numbers for all matches.

You can use also use the run_waterfall_email and run_waterfall_phone parameters to run waterfall enrichment via this endpoint. Waterfall enrichment gives you broader data coverage by checking connected third-party data sources for contact emails and phone numbers. When you call this endpoint and include at least one waterfall parameter, Apollo returns an immediate synchronous response with demographic and firmographic data, along with a waterfall enrichment request status. Apollo delivers enriched emails and/or phone numbers asynchronously to a configured webhook.

Webhook Response Details:

• When using native enrichment for phone number enrichment, the webhook response follows: Native webhook response details
• When passing Waterfall flags, the webhook response follows: Waterfall webhook response details

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.

Using this endpoint will consume credits based on your account's pricing plan. If you run waterfall enrichment parameters, your credit usage depends on the type of data you request (emails and/or phone numbers) and which data source returns enriched data. To view a summary of Apollo's pricing, visit the public pricing page ↗ For detailed information regarding API credit usage, see the API enrichment ↗ section on the About Credits page (login required).

This endpoint's rate limit is throttled to 50% of the People Enrichment endpoint's per-minute rate limit, and is 100% of the hourly and daily rate limits for the same individual endpoint.