Skip to main content
GET
/
jobs
/
{id}
Get job details
curl --request GET \
  --url https://api.nexrender.com/api/v2/jobs/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "templateId": "<string>",
  "status": "<string>",
  "progress": 123,
  "stats": {
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "startedAt": "2023-11-07T05:31:56Z",
    "finishedAt": "2023-11-07T05:31:56Z",
    "errorAt": "2023-11-07T05:31:56Z",
    "totalAssets": 123,
    "renderDuration": 123,
    "error": "<string>"
  },
  "outputUrl": "<string>"
}

​
Job Status Lifecycle

StatusDescription
queuedJob is waiting to be picked up by render engine
render:dorenderCurrently being processed
finishedSuccessfully rendered; outputUrl available
errorEncountered an error (see error field)
Instead of polling, you can configure a webhook in your job payload: 
"webhook": {
  "url": "https://yourdomain.com/render-status"
}
When the job completes (success or failure), Nexrender Cloud will POST to the specified URL with a job payload. 
{
  "id": "01JTRDF7HCR8QAHYW8GPCP4S9Y",
  "state": "finished",
  "outputUrl": "https://nexrender-output.s3.amazonaws.com/job.mp4",
  "finishedAt": "2025-08-14T08:01:10.304Z",
  "renderDuration":22.304
}
Make sure your webhook endpoint is idempotent and returns a 200 OK response.

​
Webhook Retry Logic

If your server is temporarily unavailable, Nexrender Cloud will retry delivery up to 3 times with exponential backoff. To maximize reliability:
  • Respond with 200 OK immediately (even if processing async)
  • Avoid timeouts — webhook POSTs should complete in under 2 seconds
  • Log and audit webhook deliveries

​
Summary

  • Use GET /jobs/:id to poll job state manually
  • Use webhook.url to receive async status notifications
  • Ensure your webhook endpoints are reliable and secure

​
API Reference

Authorizations

​
Authorization
string
header
required

Bearer token authentication using API tokens for team-based access control.

You can generate your own API token at: https://app.nexrender.com/team/settings

Path Parameters

​
id
string
required

Unique job identifier

Response

Successfully retrieved job details

Render job with current status, progress, and detailed statistics

​
id
string

Unique job identifier used for tracking and API operations

​
templateId
string | null

Reference to the template used for this job (null if template was not used)

​
status
string

Current job status (queued, render:dorender, finished, error, etc.)

​
progress
number<float>

Render progress as a percentage (0.0 to 100.0)

​
stats
object

Detailed timing and metadata statistics for the job

​
outputUrl
string | null

URL to the rendered content