---
title: "Get pipeline run status"
method: GET
path: "/pipeline_runs/{pipeline_run_id}/status"
tags: ["Pipeline Runs"]
---

# Get pipeline run status

`GET /pipeline_runs/{pipeline_run_id}/status`

## Request

- Base URL: `https://app.getorchestra.io/api/engine/public`
- URL: `https://app.getorchestra.io/api/engine/public/pipeline_runs/{pipeline_run_id}/status`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://app.getorchestra.io/oauth/authorize`
    - Token URL: `https://app.getorchestra.io/oauth/token` scopes: `orchestra:read`

Retrieve status details for a single [pipeline run](/docs/core-concepts/pipelines/pipeline-runs).

## Path parameters

- `pipeline_run_id` string, uuid4, required

## Headers

- `X-Orchestra-Account-Id` string, uuid4, nullable

## Response `200`

Successful response.

- PipelineRunStatusResponse: Lightweight pipeline run status response for polling.
  - `id` string, uuid4, required
  - `pipelineId` string, uuid4, required
  - `pipelineName` string, required
  - `runStatus` 'QUEUED' | 'CREATED' | 'RUNNING' | 'SUCCEEDED' | 'WARNING' | 'FAILED' | 'SKIPPED' | 'CANCELLING' | 'CANCELLED', required

## Other responses

- `401`: The request was not authorized. Check the API key and `Authorization` header.
- `403`: The request was forbidden.
- `404`: The requested resource was not found.
- `422`: Validation failed. Check path parameters, query parameters, and JSON request bodies.

## Changes

- **2026-11-03** `e45165e7e223`: 1 warning, 2 info
  - added the new `QUEUED` enum value to the `runStatus` response property for the response status `200`
  - the endpoint scheme security `BearerAuthReadOnly` was removed from the API
  - added the new optional `header` request parameter `X-Orchestra-Account-Id`

[Operation history](https://skmtc.dev/getorchestra/apis/orchestra-api/changes/pipeline_runs/:pipeline_run_id/status/get.md)

---

[API](https://skmtc.dev/getorchestra/apis/orchestra-api.md) - [All operations](https://skmtc.dev/getorchestra/apis/orchestra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getorchestra/apis/orchestra-api/revisions/daf2c16b3057?raw)