---
title: "List all jobs processed by a runner"
method: GET
path: "/api/v4/runners/{id}/jobs"
tags: ["runners", "jobs"]
---

# List all jobs processed by a runner

`GET /api/v4/runners/{id}/jobs`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/runners/{id}/jobs`
- Auth: none declared

Lists all jobs that are being processed or were processed by a specified runner. The list of jobs is limited to projects where the user has the Reporter, Developer, Maintainer, or Owner role.

## Path parameters

- `id` integer, required

## Query parameters

- `system_id` string
- `status` 'created' | 'waiting_for_resource' | 'preparing' | 'waiting_for_callback' | 'pending' | 'running' | 'success' | 'failed' | 'canceling' | 'canceled' | 'skipped' | 'manual' | 'scheduled'
- `order_by` 'id'
- `sort` 'asc' | 'desc'
- `cursor` string
- `page` integer
- `per_page` integer

## Response `200`

List all jobs processed by a runner

- APIEntitiesCiJobBasicWithProject: API_Entities_Ci_JobBasicWithProject model
  - `id` integer, required
  - `status` string, required
  - `stage` string, required
  - `name` string, required
  - `ref` string, required
  - `tag` boolean, required
  - `coverage` number, float, required
  - `allow_failure` boolean, required
  - `created_at` string, date-time, required
  - `started_at` string, date-time, required
  - `finished_at` string, date-time, required
  - `erased_at` string, date-time, required
  - `duration` number, float, required: Time spent running
  - `queued_duration` number, float, required: Time spent enqueued
  - `user` APIEntitiesUser, required
    - `id` integer, required
    - `username` string, required
    - `public_email` string, required
    - `name` string, required
    - `state` string, required
    - `locked` boolean, required
    - `avatar_url` string, required
    - `avatar_path` string
    - `custom_attributes` APIEntitiesCustomAttribute[]
      - `key` string, required
      - `value` string, required
    - `web_url` string, required
    - `created_at` string
    - `bio` string, required
    - `location` string, required
    - `linkedin` string, required
    - `twitter` string, required
    - `discord` string, required
    - `website_url` string, required
    - `github` string, required
    - `job_title` string, required
    - `pronouns` string, required
    - `organization` string, required
    - `bot` boolean, required
    - `work_information` string, required
    - `followers` string
    - `following` string
    - `is_followed` string
    - `local_time` string, required
  - `commit` APIEntitiesCommit, required: API_Entities_Commit model
    - `id` string, required
    - `short_id` string, required
    - `created_at` string, date-time, required
    - `parent_ids` string[], required
    - `title` string, required
    - `message` string, required
    - `author_name` string, required
    - `author_email` string, required
    - `authored_date` string, date-time, required
    - `committer_name` string, required
    - `committer_email` string, required
    - `committed_date` string, date-time, required
    - `trailers` object, required
    - `extended_trailers` object, required
    - `web_url` string, required
  - `pipeline` APIEntitiesCiPipelineBasic, required: API_Entities_Ci_PipelineBasic model
    - `id` integer, required
    - `iid` integer, required
    - `project_id` integer, required
    - `sha` string, required
    - `ref` string, required
    - `status` string, required
    - `source` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `web_url` string, required
  - `failure_reason` string
  - `web_url` string, required
  - `project` APIEntitiesProjectIdentity, required
    - `id` integer, required
    - `description` string, required
    - `name` string, required
    - `name_with_namespace` string, required
    - `path` string, required
    - `path_with_namespace` string, required
    - `created_at` string, date-time, required

## Other responses

- `401`: Unauthorized
- `403`: No access granted
- `404`: Runner not found

---

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