---
title: "List jobs"
method: GET
path: "/jobs"
tags: ["Jobs"]
---

# List jobs

`GET /jobs`

'A list of jobs can be obtained by sending an HTTP GET request to https://app.zencoder.com/api/v2/jobs?api_key=93h630j1dsyshjef620qlkavnmzui3 (replace the api_key with your own). It will return an array of jobs similar to the example below. The list of thumbnails will be empty until the job is completed. By default, the results are paginated with 50 jobs per page and sorted by ID in descending order. You can pass two parameters to control the paging: page and per_page. per_page has a limit of 50. Note that historical jobs data is kept by Zencoder for 60 days - if you need to keep jobs data for longer periods, you need to retrieve it within 60 days and save it in your own data storage.'

## Query parameters

- `page` integer
- `per_page` integer

## Headers

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

## Response `200`

A List of Jobs.

- JobResponseFields[] — Success response for list jobs request
  - `id` integer — The job id, an integer in the 64-bit range.
  - `submitted_at` string — ISO 8601 date-time string representing when the job was submitted
  - `created_at` string — ISO 8601 date-time string representing when the job was created
  - `updated_at` string — ISO 8601 date-time string representing when the job was last updated
  - `finished_at` string — ISO 8601 date-time string representing when the job was completed
  - `state` 'pending' | 'submitting' | 'transcoding' | 'finished' | 'failed' — 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)
  - `input_media_file` InputMediaFile — Object containing properties for the input media file.
    - `audio_bitrate_in_kbps` integer — Audio bitrate of the input media file
    - `audio_codec` string — Audio codec of the input media file
    - `audio_sample_rate` integer — Audio sample rate of the input media file
    - `audio_tracks` integer — The number of audio tracks in the input media file
    - `channels` integer — The number of audio channels in the input media file
    - `created_at` string — ISO 8601 date-time string representing when the input file was created
    - `updated_at` string — ISO 8601 date-time string representing when state of processing on the input file last changed
    - `finished_at` string — ISO 8601 date-time string representing when processing the input file finished
    - `duration_in_ms` integer — Duration in ms of the input media file
    - `error_class` string — The type of error thrown if an error occurred in processing the input file
    - `error_message` string — The error message thrown if an error occurred in processing the input file
    - `file_size_bytes` integer — The file size in bytes of the input file
    - `format` string — The format of the input file
    - `frame_rate` integer — The frame_rate of the input file
    - `height` integer — The frame height of the input file in pixels
    - `id` integer — The id of the input file, an integer in the 64-bit range.
    - `md5_checksum` integer — The checksum of the input file
    - `privacy` boolean — Privacy mode
    - `state` string — The current state of the file: - pending (not yet submitted to Zencoder) - submitting (currently submitting to Zencoder) - finished (Zencoder finished processing the file) - failed (Zencoder was unable to process the file)
    - `test` boolean — Test mode
    - `video_bitrate_in_kbps` integer — video bitrate of the input file
    - `video_codec` string — video codec of the input file
    - `width` integer — frame width of the input file in pixels
    - `total_bitrate_in_kbps` integer — total audio+video bitrate of the input file
    - `url` string — URL of the input file
  - `output_media_files` OutputMediaFile[] — Array of objects containing the properties of the output files
    - `audio_bitrate_in_kbps` integer — Audio bitrate of the output media file
    - `audio_codec` string — Audio codec of the output media file
    - `audio_sample_rate` integer — Audio sample rate of the output media file
    - `channels` integer — The number of audio channels in the output media file
    - `created_at` string — ISO 8601 date-time string representing when the output file was created
    - `updated_at` string — ISO 8601 date-time string representing when state of processing on the output file last changed
    - `finished_at` string — ISO 8601 date-time string representing when processing the output file finished
    - `duration_in_ms` integer — Duration in ms of the output media file
    - `error_class` string — The type of error thrown if an error occurred in processing the output file
    - `error_message` string — The error message thrown if an error occurred in processing the output file
    - `file_size_bytes` integer — The file size in bytes of the output file
    - `fragment_duration_in_ms` integer — Duration of final fragment for segmented types
    - `format` string — The format of the output file
    - `frame_rate` integer — The frame_rate of the output file
    - `height` integer — The frame height of the output file in pixels
    - `id` integer — The id of the output file, an integer in the 64-bit range.
    - `label` string — Label for the output
    - `md5_checksum` integer — The checksum of the output file
    - `privacy` boolean — Privacy mode
    - `rfc_6381_audio_codec` string — Audio codec for industry compatibility
    - `rfc_6381_video_codec` string — Video codec for industry compatibility
    - `state` string — The current state of the file: - pending (not yet submitted to Zencoder) - submitting (currently submitting to Zencoder) - transcoding (currently transcoding) - uploading (currently uploading the output file) - finished (Zencoder finished processing the file) - failed (Zencoder was unable to process the file)
    - `test` boolean — Test mode
    - `video_bitrate_in_kbps` integer — video bitrate of the output file
    - `video_codec` string — video codec of the output file
    - `width` integer — frame width of the output file in pixels
    - `total_bitrate_in_kbps` integer — total audio+video bitrate of the output file
    - `url` string — URL of the output file

## Other responses

- `403` — Forbidden
- `422` — Invalid query parameters
- `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)