Get the current status of a job. Returns job status, progress, timestamps, and result data if completed. Works for all job types (merge, convert, extract, etc.).
Get the current status of a job.
Returns job status, progress, timestamps, and result data if completed. Works for all job types (merge, convert, extract, etc.).
GET https://eranol.com/api/v1/ffmpeg/status/{job_id}
[
{
"job_id": "37a8d929-1bb1-40b8-bd81-1a4a633b834b",
"status": "completed",
"duration": 58.875,
"progress": null,
"created_at": 1770492104.6935267,
"resolution": "1280x720",
"result_url": "https://eranol.com/api/v1/ffmpeg/file/af390718-7794-4b36-b9c3-2693e922cf18.mp4",
"started_at": 1770492104.6968493,
"completed_at": 1770492127.4626331
}
]
Periodically call this endpoint after submitting a video render job to check progress and detect completion.
Response
{
"job_id": "1406c589-a1f4-45d5-8745-aae07bc4de38",
"status": "processing",
"progress": 67,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:45Z"
}
Retrieve the final status with result data once a job has finished.
Response
{
"job_id": "1406c589-a1f4-45d5-8745-aae07bc4de38",
"result": {
"url": "https://cdn.eranol.com/output/1406c589.mp4"
},
"status": "completed",
"progress": 100,
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:31:12Z"
}
Identify a failed job so your app can show an error message and offer a retry.
Response
{
"error": "Input URL returned 404",
"job_id": "1406c589-a1f4-45d5-8745-aae07bc4de38",
"status": "failed",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:05Z"
}
| Code | Meaning |
|---|---|
401 | Missing or invalid API key |
402 | Insufficient credits |
422 | Validation error — check your request body |
429 | Rate limit exceeded — slow down requests |
500 | Internal server error — try again or contact support |