---
title: "List pipelines"
method: GET
path: "/v4/pipelines"
tags: ["Pipelines"]
---

# List pipelines

`GET /v4/pipelines`

List pipelines

## Query parameters

- `slug` union — Filter pipelines by slug
  - string
  - object
    - `contains` string
    - `search` string
    - `startsWith` string
    - `endsWith` string
    - `in` string[]
    - `notIn` string[]
    - `mode` 'insensitive' | 'default'
- `folderId` string, uuid, nullable — The ID of the folder to filter pipelines by

## Response `200`

Successful response

- object
  - `data` Pipeline[], required
    - `id` string, uuid, required — Pipeline UUID
    - `createdAt` string, required — Creation timestamp (ISO 8601)
    - `updatedAt` string, required — Last update timestamp (ISO 8601)
    - `slug` string, required — Pipeline slug
    - `displayName` string, nullable, required — Pipeline display name
    - `folderId` string, uuid, nullable, required — Folder UUID
    - `archivedAt` string, nullable, required — Archive timestamp (ISO 8601)
    - `goldenDatasetId` string, uuid, nullable, required — Golden dataset UUID

## Other responses

- `400` — Client provided an invalid request for the pipeline. Please check the request format and parameters.
- `401` — No valid API key provided.
- `404` — The pipeline resource does not exist.
- `500` — Something went wrong on Gentrace's end.

## Changes

- **2025-04-28** `76bde656b16e` — 8 breaking, 1 warning, 1 info
  - the `data/items/archivedAt` response's property type/format changed from `string, null`/`date-time` to `string, null`/`` for status `200`
  - the `data/items/createdAt` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `data/items/updatedAt` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - removed the required property `data/items/branch` from the response with the `200` status
  - …6 more
- **2025-04-22** `610091298e37` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gentrace/apis/gentrace-api/changes/v4/pipelines/get.md)

---

[API](https://skmtc.dev/gentrace/apis/gentrace-api.md) · [All operations](https://skmtc.dev/gentrace/apis/gentrace-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gentrace/gentrace-api/revisions/938ac0c5af7b/schema)