---
title: "Get Status of Ingest Jobs"
method: GET
path: "/v1/accounts/{{account_id}}/videos/{{video_id}}/ingest_jobs"
tags: ["Videos"]
---

# Get Status of Ingest Jobs

`GET /v1/accounts/{{account_id}}/videos/{{video_id}}/ingest_jobs`

## Request

- Base URL: `https://cms.api.brightcove.com`
- URL: `https://cms.api.brightcove.com/v1/accounts/{{account_id}}/videos/{{video_id}}/ingest_jobs`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://oauth.brightcove.com/v4/access_token` scopes: `video-cloud/video/read`

Get the status of all ingest jobs associated with a video (including the original ingestion, replacing and retranscoding the video). NOTE: this operation only works for videos that were ingested using **Dynamic Delivery** profiles.

Possible states of jobs are:
  * `processing` processing is underway, but no playable renditions have been created yet
  * `publishing` at least one playable rendition has been created and is being published
  * `published` at least one rendition is available for playback
  * `finished` processing is complete
  * `failed` processing failed - if you cannot figure what went wrong, contact Support

## Path parameters

- `account_id` string, required
- `video_id` string, required

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Response `200`

200

- IngestJobStatus[]
  - `account_id` string: the Video Cloud account id
  - `error_code` string: the error code if the job failed
  - `error_message` string: the error message if the job failed
  - `id` string: the ingest job id returned when you submit the Dynamic Ingest API request
  - `priority` string: priority of the job (normal or low)
  - `started_at` string: when processing started
  - `state` 'processing' | 'publishing' | 'published' | 'finished' | 'failed': the current state of the ingest job - status: - `processing` - video processing in progress - the video is not currently playable - `publishing` - video processing in progress - publishing a playable rendition - `published` - that at least one playable rendition is available for the video - `finished` - that all processing is complete - `failed` - video processing failed to complete
  - `submitted_at` string: when the job was submitted
  - `updated_at` string: when the status was last updated
  - `video_id` string: the video id

## Other responses

- `401`: UNAUTHORIZED: Authentication failed; check to make sure your client credentials were correct for the access token
- `429`: TOO_MANY_REQUESTS: You are submitting too many simultaneous requests or too many requests per second
- `500`: INTERNAL_ERROR: Error in the backend

## Changes

- **2023-04-29** `d5befff2511b`: 1 info
  - endpoint added
- **2023-04-28** `5285220c7df0`: 1 breaking
  - api path removed without deprecation
- **2023-03-26** `751db20334e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brightcovelearning/apis/brightcove-cms-api-reference/changes/v1/accounts/:{account_id}/videos/:{video_id}/ingest_jobs/get.md)

---

[API](https://skmtc.dev/brightcovelearning/apis/brightcove-cms-api-reference.md) - [All operations](https://skmtc.dev/brightcovelearning/apis/brightcove-cms-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/brightcovelearning/apis/brightcove-cms-api-reference/revisions/1b6182a4560a?raw)