Get a render batch's status

Returns the batch with each row's own state and, once any row has succeeded, a signed archive_url for the ZIP of every succeeded file. GET never starts billed work.

get/v1/batches/{id}

Request

  • Base URL: https://thirds.ai
  • URL: https://thirds.ai/v1/batches/{id}
  • Auth: HTTP bearer

Response

The batch's current status.

idstring required
template_idstring required
versioninteger required
format'pdf' | 'png' | 'jpeg' | 'webp' required
created_atstring date-time required
state'queued' | 'running' | 'complete' | 'partial' | 'failed' | 'cancelled' required
quoted_creditsinteger required

The row count. Each successful file settles one credit. Failed and cancelled rows cost nothing. There is no bulk discount.

archive_urlstring nullable required

A signed ZIP download link, present once any row has succeeded.

Changes

No recorded changes to this operation across all 1 revision of this API.