Get a PDF's status

Return one render job's current status, in the same representation POST /v1/pdf answers with. Mints a fresh signed download link on every call while the PDF is still available.

get/v1/pdf/{id}

Request

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

Path parameters

idstring required

The job's public identifier, such as "pdf_1f8b3c7d5e2a49061f8b3c7d5e2a4906".

Response

The job's current status.

referencestring

Your reference, preserved in the job, history, and webhook. Omitted when not supplied.

idstring required

The job's public identifier: "pdf_" followed by 32 lowercase hexadecimal characters.

status'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' required
created_atstring date-time required
finished_atstring date-time nullable required
credit'reserved' | 'settled' | 'released' | 'free' | 'none' required

What happened to the credit this job holds: "reserved" while it is queued or running, "settled" once it succeeded, "released" once it failed or was cancelled, "free" when it is the account's free first file and costs no credit, and "none" when the job was never billed.

Changes

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