---
title: "Get a video job"
method: GET
path: "/videos/{id}"
---

# Get a video job

`GET /videos/{id}`

## Request

- Base URL: `https://www.ninjachat.ai/api/v1`
- URL: `https://www.ninjachat.ai/api/v1/videos/{id}`
- Auth: HTTP bearer

Poll job status until completed or failed. Prefer a webhook if you do not want to poll.

## Path parameters

- `id` string, required

## Response `200`

Video job status or completed URL.

- VideoStatusResponse
  - `id` string, required
  - `object` 'video', required
  - `status` 'queued' | 'processing' | 'completed' | 'failed', required
  - `progress` number
  - `video_url` string, uri
  - `error` string

## Other responses

- `400`: Invalid or unsupported request parameter.
- `401`: Missing or invalid API key.
- `402`: Insufficient balance or project spend limit reached.
- `404`: Video job not found.
- `429`: Rate limit exceeded.
- `500`: Gateway error.

---

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