---
title: "Pipeline Executions"
method: GET
path: "/v1/pipeline-executions"
tags: ["Pipeline Execution"]
---

# Pipeline Executions

`GET /v1/pipeline-executions`

This returns a list of summarised pipeline executions.The list is ordered by the start time of the execution, with the most recent execution first. It can be paginated by providing a `paginationToken` query parameter obtained from a previous response.

## Query parameters

- `projectId` string
- `paginationToken` string
- `limit` integer
- `pipelineName` string
- `environmentName` string
- `startedAfter` string, date-time
- `startedBefore` string, date-time
- `timeFrame` string
- `status` 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLING' | 'CANCELLED' | 'FORBIDDEN' | 'SKIPPED' | 'UNKNOWN'
- `scheduleId` string

## Response `200`

Pipelines executions returned successfully

- ScrollResultListPipelineExecution
  - `more` string — Token for fetching the next batch of results for this query; if omitted then there are no more.
  - `results` PipelineExecution[] — Results of query
    - `environmentName` string — The name of the environment the pipeline was executed in
    - `finishedAt` string, date-time — The time the pipeline execution finished
    - `message` string — The message returned by the pipeline execution
    - `pipelineExecutionId` string — The ID of the pipeline execution
    - `pipelineName` string — The name of the pipeline executed
    - `pipelineType` string — The type of pipeline executed
    - `projectId` string — The id of the project the pipeline was executed in
    - `scheduleId` string — The id of the schedule that triggered the pipeline execution if trigger is SCHEDULE
    - `startedAt` string, date-time — The time the pipeline execution started
    - `status` string — Status of executed pipeline
    - `trigger` 'DESIGNER' | 'API' | 'SCHEDULE' | 'SCHEDULE_RUN_NOW' | 'UNKNOWN' — The trigger of the pipeline execution
    - `user` string — The user that triggered the pipeline execution. Present when trigger is DESIGNER or SCHEDULE_RUN_NOW

## Other responses

- `400` — Wrong request parameters used
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Unexpected error occurred
- `503` — Service Unavailable
- `504` — Gateway timeout

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/versions/6239825f68eb/schema)