---
title: "Get Run Public V2"
method: GET
path: "/v2/jobs/runs/{run_id}"
tags: ["Jobs (public v2)"]
---

# Get Run Public V2

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

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- JobRunDetailPublicV2 — Full detail for a single run.
  - `created_at` string, date-time, required — When the run was created.
  - `error` JobRunErrorPublicV2 — Error details for a failed run.
    - `errors_sample` object[], nullable — Sample of individual error records from the run.
    - `message` string, nullable — Human-readable error message.
    - `step` string, nullable — Pipeline step where the error occurred.
  - `finished_at` string, date-time, nullable — When the run finished.
  - `id` string, required — Unique run identifier (run_<n>).
  - `inputs_sample` unknown[], nullable — Sample of the run's input records.
    - unknown
  - `job` JobContextPublicV2, required — Minimal job context embedded in a run detail.
    - `display_name` string, nullable — Human-friendly job name shown in the UI.
    - `extract_template_name` string, nullable — Name of the extract template this job runs.
    - `id` string, required — Unique job identifier (job_<n>).
    - `name` string, required — Internal job name.
    - `schedule` JobSchedulePublicV2 — Cron-based schedule controlling when a job runs automatically.
      - `cron` string, required — Cron expression defining when the job runs.
      - `enabled` boolean, required — Whether the schedule is currently active.
  - `started_at` string, date-time, nullable — When the run started executing.
  - `status` 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | 'WARNING', required — Current run status.
  - `summary` JobRunSummaryPublicV2 — Aggregate metrics for a run.
    - `input_count` integer, nullable — Number of input records processed.
    - `match_rate` number, nullable — Fraction of inputs that produced a result (result_count / input_count), from 0.0 to 1.0.
    - `result_count` integer, nullable — Number of result records produced.
  - `triggered_by` 'schedule' | 'manual', required — What triggered the run: 'schedule' or 'manual'.

## 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/9bfe220b7a29/schema)