---
title: "List pipeline runs"
method: GET
path: "/pipeline_runs"
tags: ["Pipeline Runs"]
---

# List pipeline runs

`GET /pipeline_runs`

Retrieve a paginated list of [pipeline runs](/docs/core-concepts/pipelines/pipeline-runs) for the workspace linked to the API key.

<Note>
  `time_from` and `time_to` are optional. If neither is provided, the API returns the last 7 days of data. If both are provided, the maximum time range per request is 7 days. `time_from` cannot be earlier than 2023-01-01.
</Note>

Filter by multiple statuses, pipeline IDs, or pipeline run IDs using comma-separated values. For example, `status=SUCCEEDED,FAILED` returns all pipeline runs with either status.

## Query parameters

- `status` string
- `page` integer
- `page_size` integer
- `time_from` string, date-time, nullable
- `time_to` string, date-time, nullable
- `pipeline_ids` string
- `pipeline_run_ids` string
- `environments` string

## Response `200`

Successful response.

- PaginatedResponsePipelineRunResponse
  - `page` integer, required
  - `pageSize` integer, required
  - `total` integer, required
  - `results` PipelineRunResponse[], required
    - `id` string, uuid4, required
    - `pipelineId` string, uuid4, required
    - `pipelineName` string, nullable, required
    - `accountId` string, uuid4, required
    - `envId` string, uuid4, nullable
    - `envName` string, nullable
    - `runStatus` 'CREATED' | 'RUNNING' | 'SUCCEEDED' | 'WARNING' | 'FAILED' | 'SKIPPED' | 'CANCELLING' | 'CANCELLED', required
    - `hasAnomalies` boolean, nullable
    - `anomalies` object, nullable
    - `triggeredBy` TriggeredByApiModel[]
      - `triggerType` 'MANUAL' | 'RESTART_ALL' | 'RESTART_FROM_FAILED' | 'RESTART_FROM_SELECTED' | 'RESTART_FROM_TASKS' | 'SCHEDULED' | 'SENSOR' | 'TRIGGER_EVENT' | 'WEBHOOK', required
      - `integration` 'AIRBYTE_CLOUD' | 'AIRBYTE_SERVER' | 'AIRFLOW' | 'ARCH' | 'ALTERYX_SERVER' | 'AWS_EC2' | 'AWS_ECS' | 'AWS_EMR' | 'AWS_EKS' | 'AWS_FIREHOSE' | 'AWS_GLUE' | 'AWS_LAMBDA' | 'AWS_RDS' | 'AWS_REDSHIFT' | 'AWS_S3' | 'AWS_BEDROCK' | 'AWS_SAGEMAKER' | 'AWS_SECRETS_MANAGER' | 'AZURE' | 'AZURE_CONTAINER_APPS' | 'AZURE_DATA_FACTORY' | 'AZURE_DATA_LAKE_STORAGE' | 'AZURE_KEY_VAULT' | 'AZURE_KUBERNETES_SERVICE' | 'AZURE_LOGIC_APPS' | 'AZURE_SYNAPSE_ANALYTICS' | 'AZURE_VM' | 'BAUPLAN' | 'BOOMI' | 'CDATA' | 'CENSUS' | 'CLAUDE' | 'CLICKHOUSE' | 'COALESCE' | 'COUNT' | 'DATADOG' | 'DATABRICKS' | 'DATAPROC' | 'DATAZEN' | 'DBT' | 'DBT_CORE' | 'DLT' | 'DOMO' | 'DUCKDB' | 'EMAIL' | 'ESTUARY' | 'ETLEAP' | 'FABRIC' | 'FABRIC_SYNAPSE' | 'FIVETRAN' | 'FORTRA' | 'GCP_BIG_QUERY' | 'GCP_CLOUD_RUN' | 'GCP_CLOUD_FUNCTIONS' | 'GCP_CLOUD_STORAGE' | 'GCP_DATAFLOW' | 'GCP_DATAFORM' | 'GCP_DATASTREAM' | 'GCP_LOOKER' | 'GKE' | 'GITHUB_ACTIONS' | 'GOOGLE_CLOUD' | 'HEVO' | 'HEX' | 'HIGHTOUCH' | 'HTTP' | 'INFORMATICA_IICS' | 'INFORMATICA_POWERCENTER' | 'KAFKA' | 'KEBOOLA' | 'KLEENE' | 'LIGHTDASH' | 'LINUX_SSH' | 'MATILLION' | 'MATILLION_ETL' | 'METAPLANE' | 'MICROSOFT_TEAMS' | 'MICROSTRATEGY' | 'MOTHERDUCK' | 'NIMBLE' | 'OMNI' | 'OPEN_AI' | 'ORCHESTRA' | 'PARADIME' | 'PAGER_DUTY' | 'PINECONE' | 'PORTABLE' | 'POSTGRES' | 'POWER_AUTOMATE' | 'POWER_BI' | 'PREFECT_CLOUD' | 'PYTHON' | 'QLIK' | 'QLIK_REPLICATE' | 'RENDER' | 'RIVERY' | 'RUDDERSTACK' | 'SAP' | 'SFTP' | 'SIGMA' | 'SISENSE' | 'SLACK' | 'SNOWFLAKE' | 'SNOWPLOW' | 'SODA' | 'SQL_MESH' | 'SQL_SERVER' | 'STITCH' | 'STREAMKAP' | 'TABLEAU_CLOUD' | 'TALEND_CLOUD' | 'THOUGHTSPOT' | 'TOBIKO_CLOUD' | 'WEAVIATE' | 'WEBHOOK' | 'WELD' | 'WINDOWS_SSH'
      - `scheduleName` string, nullable
      - `scheduleCron` string, nullable
      - `scheduleTimezone` string, nullable
      - `pipelineName` string, nullable
      - `pipelineId` string, uuid4, nullable
      - `pipelineRunId` string, uuid4, nullable
      - `userId` string, uuid4, nullable
      - `runTaskIds` string[], nullable
      - `runOperationIds` string[], nullable
      - `continueDownstreamRun` boolean, nullable
      - `sensorName` string, nullable
      - `sensorRunId` string, uuid4, nullable
      - `wildcardParent` boolean, nullable — When trigger_type is TRIGGER_EVENT, whether this hop matched only a wildcard (*) parent dependency edge.
    - `childPipelineRuns` ChildPipelineRunApiModel[]
      - `pipelineId` string, uuid4, required
      - `pipelineRunId` string, uuid4, required
      - `pipelineName` string, required
    - `message` string, required
    - `pipelineVersionNumber` integer, nullable
    - `createdAt` string, required
    - `updatedAt` string, required
    - `completedAt` string, nullable
    - `startedAt` string, nullable
    - `branch` string, nullable
    - `commit` string, nullable
    - `gitLink` string, nullable
    - `data` PipelineRunModel
      - `version` 'v1', required — Pipeline schema version. Currently only 'v1' is supported.
      - `name` string, required — Unique identifier for this pipeline (max 100 chars). Used in UI and API.
      - `pipeline` object, required — Dictionary mapping user-chosen IDs to task group or standalone task definitions. IDs must be unique across the entire pipeline and are referenced in dependsOn arrays. Task groups (recommended) are the primary mechanism for building DAGs -- dependencies between groups define execution order.
      - `schedule` ScheduleModel[], nullable — List of cron schedules that trigger this pipeline. Triggers use OR-logic -- any single trigger firing starts a pipeline run.
        - `name` string, nullable
        - `cron` string, required
        - `timezone` string, nullable
        - `environment` union
          - string, uuid4
          - string
        - `branch` string, nullable
        - `exclude` string[], nullable
        - `runInputs` object, nullable
      - `sensors` object, nullable — Dictionary of sensor definitions that trigger this pipeline. Triggers use OR-logic -- any single trigger firing starts a pipeline run.
      - `triggerEvents` TriggerEventModel[], nullable — List of pipeline completion events that trigger this pipeline. Triggers use OR-logic -- any single trigger firing starts a pipeline run.
        - `type` 'pipeline', required — Event type. Currently only 'pipeline' is supported.
        - `pipelineId` union, required — UUID of the pipeline whose completion triggers this pipeline. If 'ANY', triggers on any pipeline completion.
          - string, uuid4
          - '*'
        - `statuses` PipelineRunStatus[], nullable — List of pipeline run statuses that trigger this pipeline. Available values: SUCCEEDED, FAILED, WARNING, CANCELLED. If omitted, triggers on SUCCEEDED and WARNING only.
        - `runInputs` object, nullable — Input values to pass to the triggered pipeline run.
      - `webhook` WebhookModel
        - `enabled` boolean
        - `operationMetadata` object, nullable
        - `runInputs` object, nullable
      - `configuration` ConfigurationModel
        - `retries` integer, nullable
        - `retryDelay` integer, nullable
        - `timeout` integer, nullable
        - `concurrency` ConcurrencyModel
          - `maxActive` integer, nullable
      - `inputs` object, nullable — Declared inputs that can be passed when triggering the pipeline. Reference in tasks using ${{ inputs.<name> }}. Non-optional inputs without defaults must appear in all trigger runInputs.
      - `meta` object, nullable
      - `alerts` AlertModel[], nullable
        - `name` string, required
        - `statuses` AlertLevelTypes[], required
        - `destinations` AlertDestinationModel[], required
          - `integration` 'EMAIL' | 'DATADOG' | 'MICROSOFT_TEAMS' | 'PAGER_DUTY' | 'SLACK' | 'WEBHOOK', required
          - `destination` string, nullable
          - `connectionId` string, nullable
          - `parameters` union
            - BaseDatadogNotificationParametersModel
              - …
            - WebhookAlertParametersModel
              - …
        - `customMessage` string, nullable
      - `anomalies` PipelineAnomalyModel[], nullable
        - `percentageAboveBaseline` integer
        - `destinations` AlertDestinationModel[]
          - `integration` 'EMAIL' | 'DATADOG' | 'MICROSOFT_TEAMS' | 'PAGER_DUTY' | 'SLACK' | 'WEBHOOK', required
          - `destination` string, nullable
          - `connectionId` string, nullable
          - `parameters` union
            - BaseDatadogNotificationParametersModel
              - …
            - WebhookAlertParametersModel
              - …
        - `type` 'pipeline_duration_above_baseline'
      - `environment` object

## Other responses

- `401` — The request was not authorized. Check the API key and `Authorization` header.
- `403` — The request was forbidden, or the Metadata API is not enabled for this workspace.
- `422` — Validation failed. Check path parameters, query parameters, and JSON request bodies.
- `429` — Too many requests. Wait before sending more requests.

---

[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/revisions/50f4d2ba114d/schema)