---
title: "Get a pipeline by selector"
method: GET
path: "/pipeline"
tags: ["Pipelines"]
---

# Get a pipeline by selector

`GET /pipeline`

Retrieve a single pipeline by selector.
Provide only one selector: `pipeline_id`, `alias`, or the pair `repository` and `yaml_path`.

## Query parameters

- `pipeline_id` string, uuid4, nullable
- `alias` string, nullable
- `repository` string, nullable
- `yaml_path` string, nullable
- `version` integer, nullable
- `branch` string, nullable
- `commit` string, nullable

## Response `200`

Successful Response

- PipelineResponse — Pipeline summary returned by the pipelines API.
  - `id` string, uuid4, required
  - `name` string, required
  - `numTasks` integer, nullable
  - `yamlPath` string, required
  - `createdAt` string, required
  - `updatedAt` string, required
  - `paused` boolean, required
  - `triggerEvents` string, nullable
  - `webhook` string, nullable
  - `schedule` string, nullable
  - `sensors` string, nullable
  - `inputs` object, nullable
  - `productId` string, uuid4, nullable
  - `productName` string, nullable
  - `latestVersionNumber` integer, nullable
  - `publishedVersionNumber` integer, nullable
  - `storageProvider` string, nullable
  - `repository` string, nullable
  - `defaultBranch` string, nullable
  - `alias` string, nullable
  - `latestRunId` string, uuid4, nullable
  - `latestRunStatus` 'CREATED' | 'RUNNING' | 'SUCCEEDED' | 'WARNING' | 'FAILED' | 'SKIPPED' | 'CANCELLING' | 'CANCELLED'
  - `latestRunMessage` string, nullable
  - `latestRunCreatedAt` string, nullable
  - `latestRunCompletedAt` string, nullable
  - `latestRunStartedAt` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getorchestra/apis/orchestra-api.md) · [All operations](https://skmtc.net/getorchestra/apis/orchestra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getorchestra/orchestra-api/versions/50f4d2ba114d/schema)