Resources

Pipelines & Stages

A pipeline is a kanban board with ordered stages. Opportunities and projects move through a pipeline's stages over their lifecycle. Use these endpoints to discover the available pipelines and their stage IDs so you can place opportunities in the right column when you create them.

GET/v1/pipelines

List pipelines

Returns all pipelines for your workspace. The default pipeline is returned first.

Query parameters

Name	Type	Description
type	enum	Filter by pipeline type. One of: opportunity, project, custom.

GET/v1/stages

List stages for a pipeline

Returns the ordered stages for a single pipeline.

Query parameters

Name	Type	Description
pipeline_idrequired	uuid	ID of the pipeline whose stages you want to list.

List pipelines

curl "https://www.coastlinecrm.com/api/v1/pipelines?type=opportunity" \
  -H "Authorization: Bearer ck_live_..."

200 OK

{
  "data": [
    {
      "id": "ac1f1e52-...",
      "name": "Default opportunity pipeline",
      "type": "opportunity",
      "is_default": true
    }
  ]
}

List stages

curl "https://www.coastlinecrm.com/api/v1/stages?pipeline_id=ac1f1e52-..." \
  -H "Authorization: Bearer ck_live_..."

200 OK

{
  "data": [
    { "id": "11a1...", "name": "New lead",   "color": "#0073E6", "position": 0 },
    { "id": "22b2...", "name": "Appointment","color": "#22C55E", "position": 1 },
    { "id": "33c3...", "name": "Bid sent",   "color": "#F59E0B", "position": 2 }
  ]
}