Skip to main content
GET
← How Bulk Ingestion Works The jobs created by bulk endpoints such as POST /v2/wastes or the POST /v2/invoices/* routes for the organization in x-organization-id and its group, newest first. Use it to find a job whose id you no longer have, or to list the ones that failed.
Beta. Part of the bulk ingest API, in beta. The contract may still change before general availability.

Request

Headers

string
required
Your API key (see Authentication).Example: ${DCYCLE_API_KEY}
string
required
Your organization UUID. Jobs of its accepted subsidiaries are included.Example: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Query Parameters

string
Available values: processing, completed, completed_with_errors. (failed is reserved.)
string
Only the jobs of one entity type: one of the values in Entity types; the routes table gives the routes of each. Any text is accepted: a value that is not one of them returns an empty page.
datetime
Jobs created at or after this instant (ISO 8601; without an offset it is read as UTC).
datetime
Jobs created before this instant.
integer
default:"1"
Page number.
integer
default:"10"
Page size, 1 to 500.

Response

A page of jobs (200 OK): items, total, page, size. Each item is the job resource described in Get Ingest Job. Timestamps are UTC (…Z).

Common Errors

401 Unauthorized

Missing or invalid API key.

422 REQUEST_VALIDATION_FAILED

An unknown status or a malformed date. See Errors.

Get Ingest Job

Status and progress of one job

List Ingest Job Items

Per-record outcomes of a job