Pipelines API: Query CI/CD Pipeline Run History

The pipelines API provides read-only access to CI/CD run history that the platform ingests automatically from your connected source control providers. When a pipeline run completes in GitHub Actions or GitLab CI, a webhook payload is delivered to the platform and stored as a structured run record. You can query this history to surface build trends, correlate deploys with incidents, or feed data into reporting dashboards — no manual data entry required. All requests require a Bearer token in the Authorization header.

Pipeline runs are created exclusively through GitHub and GitLab webhook ingestion. The API does not expose endpoints for creating, updating, or deleting run records.

List pipeline runs

GET https://your-api-domain.com/api/v1/pipelines Returns a paginated list of all ingested pipeline run records, ordered by start time descending (most recent first).

Query parameters

number

default:"1"

Page number for pagination.

number

default:"25"

Number of records to return per page.

string

Filter by run status. Accepted values: success, failure, cancelled, in_progress.

string

Filter by source provider. Accepted values: github, gitlab.

string

Filter runs to a specific repository, in owner/repo format.

string

Filter runs triggered from a specific branch.

Response fields

object[]

required

Array of pipeline run summary objects.

Show run properties

string

required

Unique identifier for the run record.

string

required

Source provider: github or gitlab.

string

required

Repository in owner/repo format.

string

required

Branch the pipeline ran against.

string

required

Full SHA of the commit that triggered the run.

string

required

Final run status: success, failure, cancelled, or in_progress.

string

required

ISO 8601 timestamp when the run began.

string

ISO 8601 timestamp when the run completed. null if still in progress.

number

Total run duration in seconds. null if still in progress.

object

required

Pagination metadata.

Show pagination properties

number

required

Current page number.

number

required

Records per page.

number

required

Total number of matching records across all pages.

number

required

Total number of pages.

curl --request GET \
  --url 'https://your-api-domain.com/api/v1/pipelines?limit=25&status=failure&provider=github' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const params = new URLSearchParams({
  limit: '25',
  status: 'failure',
  provider: 'github',
});

const response = await fetch(
  `https://your-api-domain.com/api/v1/pipelines?${params}`,
  {
    headers: { Authorization: 'Bearer YOUR_TOKEN' },
  }
);
const data = await response.json();

import requests

response = requests.get(
    'https://your-api-domain.com/api/v1/pipelines',
    headers={'Authorization': 'Bearer YOUR_TOKEN'},
    params={
        'limit': 25,
        'status': 'failure',
        'provider': 'github',
    },
)
data = response.json()

Get a pipeline run

GET https://your-api-domain.com/api/v1/pipelines/:id Returns the full detail record for a single pipeline run, including individual job or stage results if available in the webhook payload.

Path parameters

string

required

The unique identifier of the pipeline run record.

Response fields

string

required

Unique run record identifier.

string

required

Source provider: github or gitlab.

string

required

Repository in owner/repo format.

string

required

Branch the pipeline ran against.

string

required

Full SHA of the triggering commit.

string

The commit message associated with the triggering commit.

string

Username or actor that triggered the pipeline.

string

required

Final run status: success, failure, cancelled, or in_progress.

string

required

ISO 8601 timestamp when the run began.

string

ISO 8601 timestamp when the run completed. null if still in progress.

number

Total run duration in seconds.

object[]

Individual job or stage results, if provided by the webhook payload.

Show job properties

string

required

Job or stage name.

string

required

Job-level status: success, failure, skipped, or cancelled.

number

Duration for this individual job in seconds.

object

The original webhook payload received from the provider, stored for auditability.

curl --request GET \
  --url https://your-api-domain.com/api/v1/pipelines/run_abc123 \
  --header 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch(
  'https://your-api-domain.com/api/v1/pipelines/run_abc123',
  {
    headers: { Authorization: 'Bearer YOUR_TOKEN' },
  }
);
const data = await response.json();

import requests

response = requests.get(
    'https://your-api-domain.com/api/v1/pipelines/run_abc123',
    headers={'Authorization': 'Bearer YOUR_TOKEN'},
)
data = response.json()

Overview

Incidents & Tickets

Intelligence

Operations

Platform

Pipelines API: Query CI/CD Pipeline Run History

List pipeline runs

Query parameters

Response fields

Get a pipeline run

Path parameters

Response fields

​List pipeline runs

​Query parameters

​Response fields

​Get a pipeline run

​Path parameters

​Response fields

List pipeline runs

Query parameters

Response fields

Get a pipeline run

Path parameters

Response fields