---
title: "List Job Runs Public V2"
method: GET
path: "/v2/jobs/{job_id}/runs"
tags: ["Jobs (public v2)"]
---

# List Job Runs Public V2

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

## Path parameters

- `job_id` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Request body

- string, nullable

## Response `200`

Successful Response

- ListResponseJobRunPublicV2
  - `items` JobRunPublicV2[], required — Items returned in 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'.
  - `limit` integer, required — Maximum number of items returned.
  - `offset` integer, required — Number of items skipped before this page.
  - `total` integer, required — Total number of items matching the query.

## Other responses

- `422` — Validation Error

---

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