contacts
Get bulk import job status and results
GET /v1/contacts/bulk/{job_id}
Auth required
api.contacts.manage
Returns the status and per-contact outcomes of a bulk import job
created by POST /v1/contacts/bulk. Poll until status is
completed or failed.
Per-contact outcomes are keyset-paginated by row index via the
cursor query param. Use the next_cursor from results to fetch
the next page; when next_cursor is null there are no more items.
Items are available from the time the job enters running status.
Path parameters
job_id string<uuid> required Job ID returned by POST /v1/contacts/bulk.
Query parameters
cursor string optional Opaque cursor returned from the previous page.
Responses
200 Job status and per-contact result page application/json
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The
code is internal_error. The
request_id field can be quoted to SendOps support to investigate.
application/problem+json