---
title: "Get Video Render Job by ID"
method: GET
path: "/pictoryapis/v1/jobs/{jobid}"
tags: ["Jobs"]
---

# Get Video Render Job by ID

`GET /pictoryapis/v1/jobs/{jobid}`

## Request

- Base URL: `https://api.pictory.ai`
- URL: `https://api.pictory.ai/pictoryapis/v1/jobs/{jobid}`
- Auth: API key in header `Authorization`

Retrieves the status and results of a video render job by its UUID.
While a job is processing, the response contains progress information. Once completed, it returns all output URLs (video, audio, thumbnail, subtitle files).
Poll this endpoint every 10-30 seconds, or use the `webhook` field on the render request for push notifications.

## Path parameters

- `jobid` string, uuid, required

## Response `200`

Job status retrieved. Inspect `data.status` for `in-progress`, `completed`, or `failed`. Note that `success: false` with `status: failed` is also returned with HTTP 200.

- JobStatusResponse: Unified response shape for the Get Video Render Job by ID endpoint. The fields present in `data` vary by job status.
  - `job_id` string, uuid
  - `id` string: Alternate identifier present in the JOB_NOT_FOUND error response
  - `success` boolean
  - `data` JobStatusData
    - `status` 'in-progress' | 'completed' | 'failed': Current job status
    - `renderProgress` number: Render progress percentage (0-100). Present once rendering has started.
    - `renderProgressMessage` string: Descriptive progress message (e.g. 'Generating video').
    - `renderState` string: Current render state (e.g. 'RUNNING').
    - `progress` number: 100 when status is completed
    - `videoURL` string, uri: Direct download URL for the rendered MP4 video
    - `videoShareURL` string, uri
    - `videoEmbedURL` string, uri: Embeddable URL suitable for iframes
    - `audioURL` string, uri: Direct download URL for the MP3 audio track
    - `thumbnail` string, uri
    - `srtFile` string, uri
    - `txtFile` string, uri
    - `vttFile` string, uri
    - `videoDuration` number: Total video length in seconds
    - `encodingDuration` number: Time taken to encode and render the video in seconds
    - `aiCreditsUsed` number: Total AI credits consumed for AI visual generation. Present only when the video includes scenes with `aiVisual`.
    - `youtubeClearanceCode` string: YouTube Content ID clearance code for the background music. Present only when the video uses a Melodie library track. Enter it in YouTube Studio to clear the Content ID claim on this video; valid until `youtubeClearanceExpiresAt`.
    - `youtubeClearanceExpiresAt` string, date-time: `youtubeClearanceCode` is valid until this time. After that it no longer works, and the next call returns a new code with a new expiry.
    - `error_code` string: Present when status is failed
    - `error_message` string: Present when status is failed

## Other responses

- `401`: Unauthorized
- `500`: Internal server error

## Changes

- **2026-09-15** `5210f31a6eb0`: 2 info
  - added the optional property `data/youtubeClearanceCode` to the response with the `200` status
  - added the optional property `data/youtubeClearanceExpiresAt` to the response with the `200` status

[Operation history](https://skmtc.dev/pictory/apis/pictory-api/changes/pictoryapis/v1/jobs/:jobid/get.md)

---

[API](https://skmtc.dev/pictory/apis/pictory-api.md) - [All operations](https://skmtc.dev/pictory/apis/pictory-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pictory/apis/pictory-api/revisions/9270a2874dc2?raw)
