Export People with Email

Exports people matching the same filters as People Search, with email finding. Supports all account and contact filters from the People Search API. Results are processed asynchronously; provide a webhook URL to receive notifications when the export completes.

When the job completes, we POST the result to your webhook URL.

Limit: With email in export you can request up to 10000 results per export (size maximum is 10000). Exceeding this limit returns 400 Bad Request - pagination limit exceeded.

Auto-refund window: A submission that is charged but never delivered is auto-refunded after up to 10 hours (previously 6h). Worst-case time before a STUCK_* refund appears increases accordingly — no request/response shape change.

Rate limits (per token): If a token already has 500 requests in flight, a further submit is rejected with 400 too many pending requests — drain below the cap (or wait for completions), then retry. Higher concurrency (now 10 processed at once) means the queue drains faster than before. Limits are independent per service (export-people-<token> and email-finder-<token>) and per token — separate tokens have separate budgets.

The response returns a trackId and state (e.g. PENDING) with statistics (total, success, failed, found). Use the same filters as People Search (e.g. account.employeeSize, account.industry, contact, etc.).

The header Content-Type: application/json must be included in the request.

📘 Webhook Payload: For the full webhook response schema, see Export People Webhook Payload.

🔄 Retry: We automatically retry webhook delivery up to 3 times. If you still need to re-trigger it, use Resend Export People Webhook.

Email Verification: All emails (SMTP & CATCH_ALL) returned by the API are verified in real time by BounceBan.

Body Params
account
object
contact
object
lists
object

Reference up to 10 lists per request (each list holds up to 10,000 items) to exclude the matching people from your results.

integer
required
Defaults to 0

Page number, zero-based.

integer
required
1 to 10000
Defaults to 10

Number of items to export (with email). Maximum 10000.

uri
Defaults to https://237c-5-61-35-80.ngrok-free.app

URL to receive asynchronous notification when export completes.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json