---
title: "List deal pipelines"
method: GET
path: "/api/v1/pipelines"
tags: ["Deals"]
---

# List deal pipelines

`GET /api/v1/pipelines`

## Request

- Base URL: `https://mailinapp.com`
- URL: `https://mailinapp.com/api/v1/pipelines`
- Auth: HTTP bearer

Every deal pipeline of the account with its stages in board order, the default pipeline first. Creates the default pipeline if the account has none yet. No deal data.

## Response `200`

The pipelines

- object
  - `pipelines` Pipeline[], required
    - `id` string, required
    - `name` string, required
    - `isDefault` boolean, required: Where a deal goes when no pipeline is named.
    - `stages` object[], required
      - `id` string, required
      - `name` string, required
      - `kind` 'open' | 'won' | 'lost', required

## Other responses

- `401`: Missing or invalid API key
- `429`: Too many requests for this key

---

[API](https://skmtc.dev/mailinapp/apis/mailinapp-api.md) · [All operations](https://skmtc.dev/mailinapp/apis/mailinapp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailinapp/apis/mailinapp-api/revisions/61016f797884?raw)