Build

Pipelines

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

Updated March 2026

GET/api/external/v2/pipelines

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

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):

{
  "request_id": "...",
  "timestamp": "2026-03-20T15:30:45Z",
  "data": [
    {
      "id": 1,
      "pipeline_type": "financing",
      "pipeline_name": "Financing Pipeline",
      "description": "Default financing pipeline",
      "owner_account_id": 56,
      "order": 1,
      "statuses": [
        {
          "id": 10,
          "status": "new",
          "custom_status_name": null,
          "description": "New deals",
          "order": 1,
          "icon": null
        }
      ]
    }
  ],
  "pagination": {
    "total": 3,
    "limit": 50,
    "offset": 0,
    "has_more": false
  }
}

401unauthorized

Authentication required— Missing or invalid Authorization header

400bad_request

cursor and sort cannot be combined; use offset pagination when sorting— Both cursor and sort params provided

Get Pipeline

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

Get a single pipeline with its statuses

Path parameters

pipeline_idintegerrequired

The pipeline ID

Response (200):

{
  "request_id": "a9b0c1d2-e3f4-5678-2345-789012345678",
  "timestamp": "2026-03-20T15:30:45Z",
  "data": {
    "id": 1,
    "pipeline_type": "financing",
    "pipeline_name": "Financing Pipeline",
    "description": "Default financing pipeline",
    "owner_account_id": 56,
    "order": 1,
    "statuses": [
      {
        "id": 10,
        "status": "new",
        "custom_status_name": null,
        "description": "New deals",
        "order": 1,
        "icon": null
      },
      {
        "id": 11,
        "status": "quoting",
        "custom_status_name": null,
        "description": "Deals in quoting stage",
        "order": 2,
        "icon": null
      },
      {
        "id": 12,
        "status": "term_sheet",
        "custom_status_name": null,
        "description": "Term sheet received",
        "order": 3,
        "icon": null
      },
      {
        "id": 13,
        "status": "closing",
        "custom_status_name": null,
        "description": "Deal in closing",
        "order": 4,
        "icon": null
      },
      {
        "id": 14,
        "status": "closed",
        "custom_status_name": null,
        "description": "Deal closed",
        "order": 5,
        "icon": null
      }
    ]
  }
}

401unauthorized

Authentication required— Missing or invalid Authorization header

404not_found

Pipeline not found— The ID doesn't exist or isn't accessible to the authenticated user

Move Deal to Pipeline

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

Move a deal to a pipeline stage

This endpoint is idempotent — if the deal is already in the specified pipeline and status, no change is made.

Path parameters

deal_idintegerrequired

The deal ID

Request body

pipeline_idintegerrequired

Target pipeline ID

pipeline_status_idinteger

Target status within the pipeline. Defaults to the first status in the pipeline.

Response (200):

{
  "request_id": "b0c1d2e3-f4a5-6789-3456-890123456789",
  "timestamp": "2026-03-20T15:30:45Z",
  "data": {
    "id": 87,
    "deal_id": 101,
    "pipeline_id": 1,
    "pipeline_name": "Financing Pipeline",
    "pipeline_status_id": 11,
    "status": "quoting"
  }
}

401unauthorized

Authentication required— Missing or invalid Authorization header

404not_found

Deal not found— The deal_id doesn't exist or isn't accessible to the authenticated user

400bad_request

Pipeline not found— The pipeline_id doesn't exist

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