v1

latestOpenAPI 3.0.3MIT2026-07-1411163326.7 KB

Pipeline

Get a pipeline by ID

Returns a pipeline by the pipeline ID.

get/pipeline/{pipeline-id}

Path parameters

pipeline-idstring uuid required

The unique ID of the pipeline.

Response

A pipeline object.

idstring uuid required

The unique ID of the pipeline.

project_slugstring required

The project-slug for the pipeline.

updated_atstring date-time

The date and time the pipeline was last updated.

numberinteger required

The number of the pipeline.

trigger_parametersobject

state'created' | 'errored' | 'setup-pending' | 'setup' | 'pending' required

The current state of the pipeline.

created_atstring date-time required

The date and time the pipeline was created.

Example response

{
  "id": "5034460f-c7c4-4c43-9457-de07e2029e7b",
  "project_slug": "gh/CircleCI-Public/api-preview-docs",
  "number": 25,
  "vcs": {
    "provider_name": "GitHub",
    "target_repository_url": "https://github.com/CircleCI-Public/api-preview-docs",
    "branch": "feature/design-new-api",
    "review_id": "123",
    "review_url": "https://github.com/CircleCI-Public/api-preview-docs/pull/123",
    "revision": "f454a02b5d10fcccfd7d9dd7608a76d6493a98b4",
    "tag": "v3.1.4159",
    "origin_repository_url": "https://github.com/CircleCI-Public/api-preview-docs"
  }
}