---
title: "List Runs for Job"
method: GET
path: "/v1/jobs/{job_id}/runs"
tags: ["Jobs"]
deprecated: true
---

# List Runs for Job

`GET /v1/jobs/{job_id}/runs`

## Request

- Base URL: `https://sdk.nimbleway.com`
- URL: `https://sdk.nimbleway.com/v1/jobs/{job_id}/runs`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `token`

> **Deprecated.**

List Runs for Job

## Path parameters

- `job_id` string, required

## Query parameters

- `status` string, nullable: Filter by status
- `page` integer
- `per_page` integer

## Response `200`

Successful Response

- JobRunListPublicV1: A page of job runs.
  - `items` JobRunPublicV1[], required: Runs on this page.
    - `created_at` string, date-time, required: When the run was created.
    - `finished_at` string, date-time, nullable: When the run finished.
    - `id` string, required: Unique run identifier (run_<n>).
    - `input_count` integer, nullable: Number of input records processed.
    - `job_id` string, required: Identifier of the job this run belongs to.
    - `result_count` integer, nullable: Number of result records produced.
    - `started_at` string, date-time, nullable: When the run started executing.
    - `status` 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | 'WARNING', required: Current run status.
    - `triggered_by` 'schedule' | 'manual', required: What triggered the run: 'schedule' or 'manual'.
  - `page` integer: Current page number.
  - `per_page` integer: Number of items per page.
  - `total` integer, required: Total number of runs matching the query.

## Other responses

- `422`: Validation Error

## Changes

- **2026-07-20** `d4e4f170f4f4`: 2 breaking, 1 warning, 6 info
  - the response property `page` became optional for the status `200`
  - the response property `per_page` became optional for the status `200`
  - deleted the `cookie` request parameter `token`
  - api operation id `list_job_runs_v2_jobs__job_id__runs_get` removed and replaced with `list_job_runs_public_v1_api_v1_public_jobs__job_id__runs_get`
  - …5 more
- **2026-06-18** `2562e655b8f2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nimbleway/apis/api-gateway/changes/v1/jobs/:job_id/runs/get.md)

---

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