---
title: "Get a workflow's jobs"
method: GET
path: "/workflow/{id}/job"
tags: ["Workflow"]
---

# Get a workflow's jobs

`GET /workflow/{id}/job`

Returns a sequence of jobs for a workflow.

## Path parameters

- `id` string, uuid, required

## Response `200`

A paginated sequence of jobs.

- object
  - `items` object[], required
    - `canceled_by` string, uuid — The unique ID of the user.
    - `dependencies` string[], required — A sequence of the unique job IDs for the jobs that this job depends upon in the workflow.
    - `job_number` integer — The number of the job.
    - `id` string, uuid, required — The unique ID of the job.
    - `started_at` string, date-time, required — The date and time the job started.
    - `name` string, required — The name of the job.
    - `approved_by` string, uuid — The unique ID of the user.
    - `project_slug` string, required — The project-slug for the job.
    - `status` 'success' | 'running' | 'not_run' | 'failed' | 'retried' | 'queued' | 'not_running' | 'infrastructure_fail' | 'timedout' | 'on_hold' | 'terminated-unknown' | 'blocked' | 'canceled' | 'unauthorized', required — The current status of the job.
    - `type` 'build' | 'approval', required — The type of job.
    - `requires` object — A sequence of the unique jobs and required statuses that this job depends upon in the workflow.
    - `stopped_at` string, date-time — The time when the job stopped.
    - `approval_request_id` string, uuid — The unique ID of the job.
  - `next_page_token` string, required — A token to pass as a `page-token` query parameter to return the next page of results.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/circleci/apis/api-v2.md) · [All operations](https://skmtc.net/circleci/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/circleci/api-v2/revisions/b9c0e0c24058/schema)