---
title: "Get Job Progress"
method: GET
path: "/jobs/{job_id}/progress"
tags: ["Jobs"]
---

# Get Job Progress

`GET /jobs/{job_id}/progress`

'Get the progress of a job. The return will contain one or more of the following keys: `state`, `input`, `outputs`, and `progress`.'

## Path parameters

- `job_id` string, required

## Query parameters

- `page` integer
- `per_page` integer

## Headers

- `Content-Type` string, required
- `Zencoder-Api-Key` string, required

## Response `200`

Success.

- GetProgressResponse
  - `state` string — The current state of the job: - pending (not yet submitted to Zencoder) - submitting (currently submitting to Zencoder) - transcoding (successfully submitted to Zencoder) - finished (Zencoder finished transcoding, and the job is done) - failed (Zencoder was unable to transcode the video)
  - `progress` number — The percentage complete
  - `input` InputProgressResponse — Progress in the processing of a job input file
    - `id` integer — The input id, an integer in the 64-bit range.
    - `state` 'waiting' | 'pending' | 'assigning' | 'processing' | 'finished' | 'failed' | 'cancelled' — The state of input processing
    - `progress` number — Input processing percentage completed
    - `current_event` 'downloading' | 'inspecting' — The current activity
    - `current_event_progress` number — The current activity percentage completed
  - `output` OutputProgressResponse — Progress in the processing of a job input file
    - `id` integer — The output id, an integer in the 64-bit range.
    - `state` 'waiting' | 'queued' | 'assigning' | 'processing' | 'finished' | 'failed' | 'cancelle`' | 'no input' | 'skipped' — The state of output processing
    - `progress` number — Input processing percentage completed
    - `current_event` 'downloading' | 'transcoding' | 'uploading' — The current activity
    - `current_event_progress` number — The current activity percentage completed

## Other responses

- `500` — Server error

---

[API](https://skmtc.dev/brightcovelearning/apis/zencoder-api.md) · [All operations](https://skmtc.dev/brightcovelearning/apis/zencoder-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brightcovelearning/zencoder-api/revisions/1c9ad03e166e/schema)
