curl --request GET 'https://esa.acreblitz.com/api/v2/esa-check/bulk/019953f8-8c00-7000-8000-000000000001' \
--header "X-API-Key: $ACREBLITZ_API_KEY"
{
"success": true,
"job_id": "019953f8-8c00-7000-8000-000000000001",
"provider_id": "your-provider",
"account_id": "your-account",
"provider_group_id": "work-order-42",
"status": "queued",
"total_items": 2,
"counts": {
"queued": 2,
"processing": 0,
"succeeded": 0,
"failed": 0
},
"created_at": "2026-10-05T14:00:00.000Z",
"started_at": null,
"completed_at": null,
"expires_at": null,
"status_url": "/api/v2/esa-check/bulk/019953f8-8c00-7000-8000-000000000001",
"results_url": "/api/v2/esa-check/bulk/019953f8-8c00-7000-8000-000000000001/results"
}
Bulk checks
Get bulk job status
Read processing progress and terminal counts
GET
/
api
/
v2
/
esa-check
/
bulk
/
{job_id}
curl --request GET 'https://esa.acreblitz.com/api/v2/esa-check/bulk/019953f8-8c00-7000-8000-000000000001' \
--header "X-API-Key: $ACREBLITZ_API_KEY"
{
"success": true,
"job_id": "019953f8-8c00-7000-8000-000000000001",
"provider_id": "your-provider",
"account_id": "your-account",
"provider_group_id": "work-order-42",
"status": "queued",
"total_items": 2,
"counts": {
"queued": 2,
"processing": 0,
"succeeded": 0,
"failed": 0
},
"created_at": "2026-10-05T14:00:00.000Z",
"started_at": null,
"completed_at": null,
"expires_at": null,
"status_url": "/api/v2/esa-check/bulk/019953f8-8c00-7000-8000-000000000001",
"results_url": "/api/v2/esa-check/bulk/019953f8-8c00-7000-8000-000000000001/results"
}
Read processing progress and terminal counts.
string
required
Opaque job identifier from the accepted response.
Job lifecycle
status is queued, processing, completed, completed_with_errors, or failed. The last three are terminal. completed means every item succeeded, completed_with_errors means some items succeeded and some failed, and failed means no item succeeded.
A job whose products are all confirmed to have no ESA requirement starts as completed during submission. Its results are returned inline by the submission endpoint, so you do not need to poll it.
counts reports queued, processing, succeeded, and failed items. started_at, completed_at, and expires_at can be null while work is pending. Results expire 30 days after terminal completion.
Poll with backoff (for example, every five seconds). Responses use Cache-Control: no-store. A different provider or expired/unknown job receives 404 BULK_JOB_NOT_FOUND.
curl --request GET 'https://esa.acreblitz.com/api/v2/esa-check/bulk/019953f8-8c00-7000-8000-000000000001' \
--header "X-API-Key: $ACREBLITZ_API_KEY"
{
"success": true,
"job_id": "019953f8-8c00-7000-8000-000000000001",
"provider_id": "your-provider",
"account_id": "your-account",
"provider_group_id": "work-order-42",
"status": "queued",
"total_items": 2,
"counts": {
"queued": 2,
"processing": 0,
"succeeded": 0,
"failed": 0
},
"created_at": "2026-10-05T14:00:00.000Z",
"started_at": null,
"completed_at": null,
"expires_at": null,
"status_url": "/api/v2/esa-check/bulk/019953f8-8c00-7000-8000-000000000001",
"results_url": "/api/v2/esa-check/bulk/019953f8-8c00-7000-8000-000000000001/results"
}
Errors
A malformed job UUID returns422 INVALID_REQUEST. An unknown, expired, or other-provider job returns 404 BULK_JOB_NOT_FOUND.
All routes can also return authentication, validation, rate-limit, and dependency errors. Use the error catalog and examples to choose a retry or correction. Keep X-Request-ID when present.