RESULTS_NOT_READY
The bulk job has not finished yet
Results were requested for a bulk job that is still queued or running.
- http status
- 409
- credits
- Nothing is billed for a failed request.
What it means
Bulk jobs run in the background in chunks. Until the job reports completed, the results file does not exist. The job status endpoint shows processed counts while it runs.
What to do
Poll GET /api/v1/email/bulk/{jobId} until status is completed, or pass webhook_url at creation and wait for the signed completion webhook instead of polling.
Example response
{
"success": false,
"error": {
"code": "RESULTS_NOT_READY",
"message": "The job has not finished yet. Poll its status until it reports completed.",
"request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
}
}Every error carries the request_id also sent in the X-Request-Id header; quote it when writing to support.
Related
- JOB_ALREADY_FINISHED · the bulk job cannot be cancelled any more
- JOB_CANCELLED · the bulk job was cancelled before producing results
- All error codes
- Verdicts and the risk score
- API reference
markdown version: /docs/errors/RESULTS_NOT_READY.md