---
title: "List pipelines"
url: https://docs.gleap.ai/en/reference/rest-api/find-pipelines
method: GET
path: "/pipelines"
api: "API Reference"
tag: "Pipelines"
operationId: "FindPipelines"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# List pipelines

`GET https://api.gleap.io/v3/pipelines`

List the pipelines visible to the authenticated user, most recently updated first. A pipeline is visible when it is public or explicitly shared with the user — an API service account only sees public pipelines and those it was added to. Each pipeline carries its stages in `lanes` (`id`, `title`, `color`, `order`, `archived`); pass a lane's `id` as `laneId` when adding or moving entries.

## Authorization

- `Authorization` (header, required): `Bearer <token>`

## Headers

- `project` (string, required)

## Example request

```bash
curl --request GET \
  --url https://api.gleap.io/v3/pipelines \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>'
```

## Responses

### 200 (`application/json`)

Ok

- `updatedAt` (string, required)
- `createdAt` (string, required)
- `sortBy` (any)
- `icon` (string)
- `color` (string)
- `organisation` (object)
  - `isValid` (object)
  - `createFromHexString` (object)
  - `createFromTime` (object)
  - `generate` (object)
  - `cacheHexString` (any)
  - `prototype` (string)
- `name` (string)
- `columns` (any[], required)
- `lanes` (any[], required)
- `recordType` (enum<string>, required): What a pipeline holds. Persisted values — never rename a member, only add. One of: `COMPANY`, `CONTACT`.
- `viewType` (enum<string>, required): One of: `board`, `table`.
- `isPublic` (boolean, required)
- `project` (object, required)
  - `isValid` (object)
  - `createFromHexString` (object)
  - `createFromTime` (object)
  - `generate` (object)
  - `cacheHexString` (any)
  - `prototype` (string)
- `users` (string[], required)
- `_id` (string, required)

```json
[
  {
    "updatedAt": "string",
    "createdAt": "string",
    "icon": "string",
    "color": "string",
    "organisation": {
      "isValid": {},
      "createFromHexString": {},
      "createFromTime": {},
      "generate": {}
    },
    "name": "string",
    "columns": [],
    "lanes": [],
    "recordType": "COMPANY",
    "viewType": "board",
    "isPublic": true,
    "project": {
      "isValid": {},
      "createFromHexString": {},
      "createFromTime": {},
      "generate": {}
    },
    "users": [
      "string"
    ],
    "_id": "string"
  }
]
```