Skip to main content
GET
/
v1
/
renders
/
{id}
Get render status
curl --request GET \
  --url https://api.craftkit.dev/v1/renders/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3f2a1b4c-5d6e-7f80-9a1b-2c3d4e5f6071",
  "status": "succeeded",
  "pollUrl": "https://api.craftkit.dev/v1/renders/3f2a1b4c-5d6e-7f80-9a1b-2c3d4e5f6071",
  "downloadUrl": "https://cdn.craftkit.dev/renders/3f2a1b4c.pdf",
  "errorMessage": null,
  "createdAt": "2026-06-21T10:00:00.000Z",
  "completedAt": "2026-06-21T10:00:04.000Z",
  "durationMs": 4123
}

Authorizations

​
Authorization
string
header
required

Project API key (ck_live_… or ck_test_…) presented as a bearer token. For embed partner endpoints this is the partner secret key, which is the same credential type.

Path Parameters

​
id
string<uuid>
required

The render id.

Response

The render.

Render shape returned by render/idempotent-replay and embed form-submit.

​
id
string<uuid>
required
​
status
enum<string>
required
Available options:
queued,
rendering,
succeeded,
failed,
cancelled
​
pollUrl
string<uri>
required
​
downloadUrl
string<uri> | null
required
​
errorMessage
string | null
required
​
createdAt
string<date-time>
required
​
completedAt
string<date-time> | null
​
durationMs
integer | null