# Pipelines

> List pipelines, view pipeline details, and manage deal pipeline progression in the Lev API.

Source: https://www.lev.com/docs/build/pipelines

Last updated: March 2026

---
## Overview

Lev supports multiple pipeline types (financing, acquisition, custom). Each pipeline has a set of statuses representing deal stages.

| Endpoint | Description |
|----------|-------------|
| `GET /pipelines` | List all pipelines |
| `GET /pipelines/{pipeline_id}` | Get a pipeline with its statuses |
| `POST /deals/{deal_id}/pipeline` | Move a deal to a pipeline stage |

## List Pipelines

### `GET /api/external/v2/pipelines`

List all pipelines available to your account

Response: `200`

#### Error Responses

- **401** (unauthorized): Authentication required
- **400** (bad_request): cursor and sort cannot be combined; use offset pagination when sorting

## Get Pipeline

### `GET /api/external/v2/pipelines/{pipeline_id}`

Get a single pipeline with its statuses

#### Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `pipeline_id` | `integer` | Yes | The pipeline ID |

Response: `200`

#### Error Responses

- **401** (unauthorized): Authentication required
- **404** (not_found): Pipeline not found

## Move Deal to Pipeline

### `POST /api/external/v2/deals/{deal_id}/pipeline`

Move a deal to a pipeline stage

#### Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `deal_id` | `integer` | Yes | The deal ID |

#### Request Body

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `pipeline_id` | `integer` | Yes | Target pipeline ID |
| `pipeline_status_id` | `integer` | No | Target status within the pipeline. Defaults to the first status in the pipeline. |

Response: `200`

#### Error Responses

- **401** (unauthorized): Authentication required
- **404** (not_found): Deal not found
- **400** (bad_request): Pipeline not found

## Pipeline Object

| Field | Type | Description |
|-------|------|-------------|
| `id` | integer | Pipeline identifier |
| `pipeline_type` | string\|null | Pipeline type (financing, acquisition, etc.) |
| `pipeline_name` | string\|null | Pipeline display name |
| `description` | string\|null | Pipeline description |
| `owner_account_id` | integer\|null | Owning account ID |
| `order` | integer\|null | Display order |
| `statuses` | array | Pipeline statuses (see Pipeline Status Object) |

## Pipeline Status Object

| Field | Type | Description |
|-------|------|-------------|
| `id` | integer | Status identifier |
| `status` | string | Status key name |
| `custom_status_name` | string\|null | Custom display name |
| `description` | string\|null | Status description |
| `order` | integer\|null | Display order within the pipeline |
| `icon` | string\|null | Icon identifier |