Skip to main content
GET
/
task-processing-jobs
/
{job_id}
Get Video-to-Task Processing Status
curl --request GET \
  --url https://api.curalabs.io/v1/task-processing-jobs/{job_id} \
  --header 'X-API-Key: <api-key>'
{
  "job_id": "vwp_abc123def456",
  "status": "processing",
  "task_id": "tsk_xyz789abc123",
  "error": "Video format not supported.",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
Poll this endpoint to check the status of a video-to-task generation job using the job_id returned by the upload endpoint. See the API Reference for details on operationId: getTaskProcessingJobStatus.

Authorizations

​
X-API-Key
string
header
required

API Key provided by the platform. Note- X-Timestamp and X-Signature headers are also required for authentication, but not defined as separate schemes here due to OpenAPI limitations on complex signature schemes.

Path Parameters

​
job_id
string
required

The ID of the video processing job.

Example:

"vwp_abc123def456"

Response

OK. Current status and details of the video processing job.

​
job_id
string

Unique identifier for the video processing job.

Example:

"vwp_abc123def456"

​
status
enum<string>

Current status of the processing job.

Available options:
queued,
processing,
completed,
failed
Example:

"processing"

​
task_id
string | null

Identifier of the task definition created from the video if status is 'completed'.

Example:

"tsk_xyz789abc123"

​
error
string | null

Error message if the job failed.

Example:

"Video format not supported."

​
created_at
string<date-time>

ISO 8601 timestamp when the job was created.

​
updated_at
string<date-time>

ISO 8601 timestamp when the job was last updated.