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.
post
https://api.ai-ark.com/api/developer-portal/v1/people/export