---
title: "Get Video Job Endpoint"
method: GET
path: "/api/v1/video/project/{projectId}/job/{jobId}"
tags: ["Video"]
---

# Get Video Job Endpoint

`GET /api/v1/video/project/{projectId}/job/{jobId}`

## Request

- Base URL: `https://mockupper.damdafa.com/mockupper`
- URL: `https://mockupper.damdafa.com/mockupper/api/v1/video/project/{projectId}/job/{jobId}`
- Auth: HTTP bearer

Get a video generation job by ID.

## Path parameters

- `projectId` string, required
- `jobId` string, required

## Headers

- `ProviderId` 'firebase' | 'google' | 'apple'
- `X-Provider-Id` 'firebase' | 'google' | 'apple'
- `X-Device-Id` string, nullable

## Response `200`

Successful Response

- VideoDocument: Firestore document structure for a video job.
  - `id` string, required
  - `projectId` string, required
  - `versionId` string, required
  - `status` 'PENDING' | 'PLANNING' | 'GENERATING' | 'COMPLETED' | 'FAILED', required
  - `prompt` string, required
  - `plan` VideoPlanSchema: Schema for the video generation plan structure output by the LLM.
    - `plan` string, required: The creative concept and narrative plan for the video.
    - `steps` string[]: Step by step execution breakdown.
    - `prompt_for_veo` string, required: The highly detailed, visual prompt to be sent to the video generation AI.
    - `rationale` string, nullable: Reasoning behind the plan.
  - `videoUrl` string, nullable
  - `thumbnailUrl` string, nullable
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `error` string, nullable
  - `errorCode` string, nullable

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/damdafa/apis/mockupper-api.md) · [All operations](https://skmtc.dev/damdafa/apis/mockupper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/damdafa/apis/mockupper-api/revisions/5713d43bfed1?raw)