Skip to content

Get Pipeline ​

GET /external/v1/pipelines/:id

Returns one pipeline with its ordered stages. Unlike List pipelines, this endpoint resolves any pipeline of your account, including inactive ones and the ones hidden by the visibility rule, so a pipeline_id taken from an opportunity, its history or a webhook always resolves.

Authentication ​

Requires pipelines:read permission.

Path Parameters ​

ParameterTypeRequiredDescription
idstringYesPipeline ID

Request ​

bash
curl --request GET \
  --url "https://app.getraze.com/external/v1/pipelines/pipe_01" \
  --header "X-API-Key: YOUR_API_KEY"
javascript
const axios = require('axios');

const response = await axios.get('https://app.getraze.com/external/v1/pipelines/pipe_01', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});

console.log(response.data);
python
import requests

response = requests.get(
    'https://app.getraze.com/external/v1/pipelines/pipe_01',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

print(response.json())

Response ​

json
{
  "success": true,
  "data": {
    "id": "pipe_01",
    "name": "Sales",
    "description": null,
    "color": "blue",
    "icon": "target",
    "is_default": true,
    "is_active": true,
    "project_id": "proj_01",
    "display_order": 0,
    "created_at": "2026-01-10T08:00:00Z",
    "updated_at": "2026-01-10T08:00:00Z",
    "stages": [
      {
        "id": "stg_new",
        "pipeline_id": "pipe_01",
        "name": "New",
        "color": "gray",
        "position": 0,
        "is_win_stage": false,
        "is_loss_stage": false
      },
      {
        "id": "stg_proposal",
        "pipeline_id": "pipe_01",
        "name": "Proposal",
        "color": "blue",
        "position": 1,
        "is_win_stage": false,
        "is_loss_stage": false
      },
      {
        "id": "stg_won",
        "pipeline_id": "pipe_01",
        "name": "Won",
        "color": "green",
        "position": 5,
        "is_win_stage": true,
        "is_loss_stage": false
      }
    ]
  }
}

The fields are the same as in List pipelines.

Errors ​

StatusCodeDescription
400VALIDATION_ERRORid is not a UUID
403INSUFFICIENT_PERMISSIONSThe API key lacks pipelines:read
404NOT_FOUNDNo pipeline with this id in your account

GetRaze - AI-Powered Lead Generation