API v2 · Jobs
Job Status
Fetch the status and result for an async video job owned by the API key user.
GET
/api/v2/jobs/{job_id}Authentication
Send your API key as a bearer token on every request.
Header
Authorization: Bearer vba_your_api_keyRequest Parameters
Send these values in the path or query as described.
| Field | Type | Required | Description |
|---|---|---|---|
| job_id | string | Path | Job ID returned by a video processing endpoint. |
Response
Successful responses use JSON. Video feature endpoints return an async job_id rather than the final processed video immediately.
| Field | Type | Required | Description |
|---|---|---|---|
| success | boolean | Yes | True when the job was found. |
| job_id | string | Yes | Requested job ID. |
| status | queued | processing | completed | failed | Yes | Normalized job status. |
| result_url | string URL | No | Final processed video URL when completed. |
| credits_used | number | No | Credits used for the job. |
| created_at | ISO datetime | Yes | Job creation timestamp. |
| updated_at | ISO datetime | Yes | Last update timestamp. |
JSON
{
"success": true,
"job_id": "job_abc123",
"status": "completed",
"result_url": "https://cdn.bgblur.com/results/video.mp4",
"credits_used": 12,
"created_at": "2026-07-01T09:00:00.000Z",
"updated_at": "2026-07-01T09:02:00.000Z"
}Example
curl
curl -X GET https://www.bgblur.com/api/v2/jobs/{job_id} \
-H "Authorization: Bearer vba_your_api_key"Tips
- Poll every few seconds. Avoid tight loops because rate limits still apply.