---
title: "Get a pipeline run"
method: GET
path: "/v1/pipelines/{id}"
tags: ["Pipelines"]
---

# Get a pipeline run

`GET /v1/pipelines/{id}`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/pipelines/{id}`
- Auth: HTTP bearer

Run detail. `?include=phases` adds the run's FROZEN phase plan — the
configuration compiled when the run was created, i.e. what this run
actually executed. That can differ from what the Spec compiles to today
(a rail edit, a republish, a new policy version), so comparing it with
`phases` on `GET /v1/specs/{id}` shows the drift. Same shape and the same
`rail_stage_id` join key.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `include` 'phases'

## Response `200`

Run detail: id, name, status, schema, phase_count, links (+ phases when requested).

- object
  - `id` string, uuid
  - `name` string
  - `status` string
  - `schema` object
    - `id` string, uuid
  - `phase_count` integer
  - `phases` SpecPhase[]: Present only with `?include=phases`. The run's frozen plan.
    - `number` integer: 1-based execution order.
    - `phase_id` string, nullable: Positional id within the plan.
    - `type` string, nullable
    - `name` string, nullable
    - `rail_stage_id` string, nullable: The rail stage this phase compiled from — join key to `nodes[].node_id`, and the per-step cost-attribution key on `/v1/usage/pipelines/{id}`. `null` only for a rail-less extraction.
    - `policy_id` string, uuid: Resolution phases.
    - `validation_stage_id` string, uuid: Validation phases — one per gate.
    - `matcher_stage_id` string, uuid: Matching phases.
    - `scope` string: `pipeline` for a post-assembly phase; absent in the per-document loop.
  - `created_at` string, date-time
  - `links` object

## Other responses

- `404`: Pipeline not found

---

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