---
title: "Get Run"
method: GET
path: "/v1/jobs/runs/{run_id}"
tags: ["Jobs"]
deprecated: true
---

# Get Run

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

## Request

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

> **Deprecated.**

Get Run

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- JobRunDetailPublicV1: Full detail for a single run.
  - `created_at` string, date-time, required: When the run was created.
  - `error` JobRunErrorPublicV1: 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` JobContextPublicV1, required: Minimal job context embedded in a run detail.
    - `agent_name` string, nullable: Name of the agent this job runs.
    - `display_name` string, nullable: Human-friendly job name shown in the UI.
    - `id` string, required: Unique job identifier (job_<n>).
    - `name` string, required: Internal job name.
    - `schedule` JobSchedulePublicV1: 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` JobRunSummaryPublicV1: 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

## Changes

- **2026-07-20** `d4e4f170f4f4`: 1 warning, 10 info
  - deleted the `cookie` request parameter `token`
  - api operation id `get_run_v2_jobs_runs__run_id__get` removed and replaced with `get_run_public_v1_api_v1_public_jobs_runs__run_id__get`
  - the endpoint scheme security `APIKeyCookie` was added to the API
  - the endpoint scheme security `HTTPBearer` was added to the API
  - …7 more
- **2026-07-13** `e8a97dc9fce2`: 6 info
  - added `#/components/schemas/CrustJobRunError` to the `error` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/CrustJobRunSummary` to the `summary` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/CrustJobSchedule` to the `job/schedule` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/JobRunError` from the `error` response property `anyOf` list for the response status `200`
  - …2 more
- **2026-06-18** `2562e655b8f2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nimbleway/apis/api-gateway/changes/v1/jobs/runs/:run_id/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)