DocsAPI referenceClient

Read a job the client token may read

The job as an app sees it: state, progress, error and outputs with signed links. Any other job answers 404.

GET /v1/client/jobs/{id}

Needs an API key: Authorization: Bearer $VIDEXO_API_KEY.

Parameters

Parameters
Name	In	Type	Description
`id` required	path	string, up to 64 characters	The job id.

Request

bash

curl "$VIDEXO_API_URL/v1/client/jobs/job_3k9x0c2mfq8w1n7r5t4b6v2z" \
  -H "Authorization: Bearer $CLIENT_TOKEN"

JavaScript

const response = await fetch(`${process.env.VIDEXO_API_URL}/v1/client/jobs/job_3k9x0c2mfq8w1n7r5t4b6v2z`, {
  headers: { Authorization: `Bearer ${clientToken}` },
});
const job = await response.json();

Response

200 JSON

{
  "id": "job_3k9x0c2mfq8w1n7r5t4b6v2z",
  "state": "succeeded",
  "progress": 1,
  "error": null,
  "outputs": [
    {
      "alias": "out_video",
      "filename": "talk-720p.mp4",
      "size_bytes": 300000000,
      "content_type": "video/mp4",
      "expires_at": "2026-11-05T12:01:09.000Z",
      "deleted_at": null,
      "download_url": "https://api.videxo.io/v1/files/job_3k9x0c2mfq8w1n7r5t4b6v2z/out_video?account=acc_example&expires=1793797269&signature=example",
      "download_url_expires_at": "2026-11-04T13:01:09.000Z"
    }
  ],
  "created_at": "2026-11-04T12:00:00.000Z",
  "started_at": "2026-11-04T12:00:04.000Z",
  "finished_at": "2026-11-04T12:01:09.000Z"
}

Responses

Responses
Status	Body	When
200	ClientJob	The job.
401	Problem	authentication_failed (missing_client_token, invalid_client_token, client_token_expired, client_token_superseded, client_token_revoked)
403	Problem	permission_denied (client_token_required, token_scope, origin_not_allowed, account_disabled)
404	Problem	not_found (job)
429	Problem	rate_limited, with Retry-After in seconds