Skip to main content
POST
Buy email addresses across prospects
Pass peopleIds from List every person. To restrict the lookup to one prospect, use Find Outreach Email. The 202 response reports queued, queuedPeopleIds, skipped, and creditsCharged. queuedPeopleIds are person IDs, not worker job IDs. Poll List every person while queued people have status enriching; their rows report the eventual address or failure. The request charges 10 AI credits per eligible person queued. People already looked up or mid-lookup are skipped without a charge. Lookups that cannot be started or finish without an address are refunded, so creditsCharged is the upfront total, not necessarily the final cost.

Authorizations

Authorization
string
header
required

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

Body

application/json
peopleIds
string[]
required
Required array length: 1 - 2000 elements

Response

202 - application/json

Default Response

ok
boolean
queued
integer
queuedPeopleIds
string[]

People whose email lookups were accepted. Read their terminal statuses from the people list; these are not worker job IDs.

skipped
integer
creditsCharged
number