Skip to main content
GET https://api.craftkit.dev/v1/renders/:id
Returns the current state of a render. Valid for your project key indefinitely — the durable record for offline-replay flows. Poll this until status is terminal.

​
Authorization

​
Authorization
string
required
Bearer ck_live_… — must be the project that owns the render.

​
Path parameters

​
id
string
required
The render id.

​
Response

​
id
string
​
status
string
queued · rendering · succeeded · failed. See the enum.
​
pollUrl
string
​
downloadUrl
string | null
Populated when succeeded. Permanent public URL — see durability.
​
errorMessage
string | null
Set when failed.
​
createdAt
string
​
completedAt
string | null
​
durationMs
number | null

​
Errors

​
404 not_found
No render with that id in this key’s project.
cURL
curl https://api.craftkit.dev/v1/renders/$RENDER_ID \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
200
{
  "id": "…",
  "status": "succeeded",
  "pollUrl": "https://api.craftkit.dev/v1/renders/…",
  "downloadUrl": "https://…/renders/…/….pdf",
  "errorMessage": null,
  "createdAt": "2026-06-05T10:00:00.000Z",
  "completedAt": "2026-06-05T10:00:03.120Z",
  "durationMs": 3120
}