---
title: "Get a generation job"
method: GET
path: "/generation-jobs/{jobId}"
tags: ["Platform"]
---

# Get a generation job

`GET /generation-jobs/{jobId}`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/generation-jobs/{jobId}`
- Auth: API key in header `Authorization`

Get a generation job.

## Path parameters

- `jobId` string, uuid, required

## Response `200`

Successful response

- object
  - `recovery` object, nullable, required
    - `jobId` string, nullable, required
    - `runId` string, nullable, required
    - `failure` object, required
      - `category` 'copyright' | 'content_policy' | 'reference' | 'invalid_input' | 'temporary' | 'unknown', required
      - `message` string, required
      - `stage` 'input' | 'output' | 'unknown', required
      - `retryable` boolean, required
      - `model` string, nullable, required
      - `provider` string, nullable, required
    - `credits` object, required
      - `status` 'not_charged' | 'charged' | 'refunded' | 'pending' | 'unknown', required
      - `charged` number, nullable, required
      - `refunded` number, nullable, required
      - `net` number, nullable, required
    - `history` object, required
      - `originalRequest` string, nullable, required
      - `authoredPrompt` string, nullable, required
      - `submittedPrompt` string, nullable, required
      - `enhancementApplied` boolean, required
      - `previousJobId` string, nullable, required
      - `previews` object[], required
        - `before` string, required
        - `after` string, required
        - `approach` 'clarify' | 'original_character', required
        - `createdAt` string, required
      - `settings` object, required
      - `references` string[], required
      - `providerRequests` object[], required
        - `id` string, required
        - `provider` string, required
        - `status` string, required
    - `alternatives` object[], required
      - `model` string, required
      - `label` string, required
      - `segments` number[], required
      - `estimatedCredits` number, required
      - `resolution` string, nullable, required
      - `outputResolution` string, nullable, required
      - `aspectRatio` string, required
      - `generateAudio` boolean, required
      - `requiresAssembly` boolean, required
      - `acceptance` 'unverified', required
    - `actions` string[], required
    - `reviewUrl` string, required
  - `audio_recovery` object, nullable, required
    - `attempt` integer, required
    - `mode` 'saved_audio_only', required
  - `content_direction` object, required
    - `snapshot` object, nullable, required
      - `capturedAt` string, required
      - `scope` object, required
        - `kind` 'brand' | 'series', required
        - `seriesId` string, uuid, nullable, required
        - `name` string, required
      - `brand` object, required
        - `title` string, required
        - `sources` object[], required
          - `url` string, uri, required
          - `title` string, required
        - `path` string, required
        - `documentId` string, uuid, nullable, required
        - `revision` integer, required
        - `markdown` string, required
        - `contentHash` string, required
      - `series` object, nullable, required
        - `title` string, required
        - `sources` object[], required
          - `url` string, uri, required
          - `title` string, required
        - `path` string, required
        - `documentId` string, uuid, nullable, required
        - `revision` integer, required
        - `markdown` string, required
        - `contentHash` string, required
    - `status` 'current' | 'changed' | 'unavailable' | 'unrecorded', required
    - `current` object, nullable, required
      - `brandRevision` integer, required
      - `brandContentHash` string, required
      - `seriesRevision` integer, nullable, required
      - `seriesContentHash` string, nullable, required
  - `job_id` string, uuid, required
  - `kind` 'image' | 'video' | 'voiceover' | 'music' | 'sound' | 'faceless', required
  - `status` 'queued' | 'processing' | 'complete' | 'failed' | 'canceled', required
  - `progress` number, required
  - `status_url` string, uri, required
  - `cancel_url` string, uri, required
  - `project_id` string, uuid, nullable, required
  - `media_id` string, uuid, nullable, required
  - `download_url` string, uri, nullable, required
  - `estimated_credits` number, nullable, required
  - `result` object, nullable, required
  - `error` string, nullable, required
  - `created_at` string, required
  - `completed_at` string, nullable, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)