Skip to main content
POST
Bulk People Enrichment
Enrich up to 10 people in one call. Body takes details, an array of the same identifier objects post_apollo_people_match accepts. Returns matches alongside status, total_requested_enrichments, unique_enriched_records, missing_records and credits_consumed — read missing_records rather than assuming every input matched. Costs one credit per record enriched, not per call. Use this over a loop of single calls: same credits, one round trip. For a single person post_apollo_people_match is simpler.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. The commands per client, and what each call costs, are on aisa.one/mcp.
Set this endpoint up in your agent →

Cost and request rules

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 1.7775
  • Declared unit rate (USD): 0.0
  • Billing unit: provider_credit
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

reveal_phone_number
boolean
default:false
run_waterfall_email
boolean
default:false
run_waterfall_phone
boolean
default:false
webhook_url
string<https_url>
Required string length: 1 - 2048

Body

application/json
details
object[]
required

Provide info for each person you want to enrich as an object within this array. Add up to 10 people.

Response

Successful response

status
string

Response field

error_code
string

Response field

error_message
string

Response field

total_requested_enrichments
integer

Response field

unique_enriched_records
integer

Response field

missing_records
integer

Response field

credits_consumed
integer

Response field

matches
string[]

Response array

waterfall
object

Response object