Resources

Pipelines

List pipelines and retrieve a pipeline with its full stage layout. Pipelines organize deals through your sales stages, from lead to close. A workspace has exactly one pipeline today, so List Pipelines returns a single entry - the endpoint is plural because the resource is, not because a workspace can hold several.

List Pipelines

GET /api/v1/pipelines

Query parameters

`page` integer	Page number, starts at `1`. Defaults to `1`.
`page_size` integer	Page size. Default 20. Max 100 - higher values are silently capped at 100 (no error). Defaults to `20`.
`sort` string	Sort spec

Returns

Paginated pipeline list.

GET /api/v1/pipelines

curl 'https://api.dreamteamcrm.ai/api/v1/pipelines?page=1&page_size=20&sort=created_at,desc' \
  -H 'Authorization: Bearer <YOUR_TOKEN>'

{
  "results": [
    {
      "created_at": "2026-02-02T12:30:14.308047Z",
      "created_by": 1000000,
      "deleted": false,
      "description": "Standard deal flow pipeline with common stages (e.g., Lead In, Qualified, Proposal, Negotiation, Closed Won/Lost).",
      "external_id": "default_pipeline",
      "id": 1000000,
      "is_default": true,
      "name": "Default Pipeline",
      "updated_at": "2026-05-20T10:06:06.332465Z"
    }
  ],
  "metadata": {
    "page": 1,
    "page_size": 20,
    "total_elements": 1,
    "total_pages": 1,
    "has_next": false,
    "has_previous": false
  }
}

Paginated pipeline list.

Get Pipeline by ID

GET /api/v1/pipelines/{id}

Path parameters

id integer · required

Returns

The pipeline with all its stages nested under stages. Each stage carries the fields below - use them to decide the "next" stage or to detect a closed deal.

Stage fields

`stage_order`	Integer. Position of the stage in the pipeline (1-based).
`stage_category`	Common values: `Early Stage`, `Mid-Level Stage`, `Late Stage`, `Closed Won`, `Closed Lost`. An admin configures the stages for the workspace, so read the labels from the response rather than assuming this set.
`win_probability`	Integer 0-100. Used for pipeline forecasting.
`is_closed`	Boolean. `true` for terminal stages (Closed Won / Closed Lost). Once a deal moves to an `is_closed: true` stage it's considered done.
`entry_criteria`	Optional free text describing what should be true before a deal enters this stage.

Assigning stages to deals

Use stage_id from this response when creating or updating a deal via the Records endpoints. pipeline_id on the deal must match the pipeline that owns the stage.

GET /api/v1/pipelines/{id}

curl 'https://api.dreamteamcrm.ai/api/v1/pipelines/1000000' \
  -H 'Authorization: Bearer <YOUR_TOKEN>'

{
  "created_at": "2026-02-02T12:30:14.308047Z",
  "created_by": 1000000,
  "deleted": false,
  "description": "Standard deal flow pipeline with common stages (e.g., Lead In, Qualified, Proposal, Negotiation, Closed Won/Lost).",
  "external_id": "default_pipeline",
  "id": 1000000,
  "is_default": true,
  "name": "Default Pipeline",
  "updated_at": "2026-05-20T10:06:06.332465Z",
  "stages": [
    {
      "created_at": "2026-02-02T12:30:15.735097Z",
      "created_by": 1000000,
      "deleted": false,
      "description": "",
      "entry_criteria": "Product demo or walkthrough done
Customer is actively exploring solutions (not just browsing)
Requirements documented
Multiple stakeholders engaged (if applicable)",
      "external_id": "default_stage_default_evaluation",
      "id": 1000002,
      "is_closed": false,
      "name": "Evaluation",
      "pipeline_id": 1000000,
      "stage_category": "Early Stage",
      "stage_order": 1,
      "updated_at": "2026-06-16T08:30:08.840559Z",
      "win_probability": 30
    },
    {
      "created_at": "2026-02-02T12:30:15.005203Z",
      "created_by": 1000000,
      "deleted": false,
      "description": "",
      "entry_criteria": "Customer problem/use case clearly identified
Basic fit confirmed (industry, size, need)
Key stakeholder identified
First call completed",
      "external_id": "default_stage_default_requirements_qualified",
      "id": 1000001,
      "is_closed": false,
      "name": "Requirements Qualified",
      "pipeline_id": 1000000,
      "stage_category": "Early Stage",
      "stage_order": 2,
      "updated_at": "2026-06-16T08:30:09.206247Z",
      "win_probability": 10
    },
    {
      "created_at": "2026-02-02T12:30:16.399426Z",
      "created_by": 1000000,
      "deleted": false,
      "description": "",
      "entry_criteria": "Pricing shared with customer
Solution scope defined
Customer confirms interest in moving forward
Decision process/timeline understood",
      "external_id": "default_stage_default_proposal",
      "id": 1000003,
      "is_closed": false,
      "name": "Proposal Sent",
      "pipeline_id": 1000000,
      "stage_category": "Mid-Level Stage",
      "stage_order": 3,
      "updated_at": "2026-06-17T07:08:26.438759Z",
      "win_probability": 40
    },
    {
      "created_at": "2026-02-02T12:30:17.072626Z",
      "created_by": 1000000,
      "deleted": false,
      "description": "",
      "entry_criteria": "Customer has reviewed proposal
Commercial terms being discussed (price, discounts, terms)
Decision-makers actively involved
Clear intent to buy (if terms align)",
      "external_id": "default_stage_default_negotiation",
      "id": 1000004,
      "is_closed": false,
      "name": "Negotiation",
      "pipeline_id": 1000000,
      "stage_category": "Late Stage",
      "stage_order": 4,
      "updated_at": "2026-06-17T07:08:27.167165Z",
      "win_probability": 70
    },
    {
      "created_at": "2026-02-02T12:30:17.717386Z",
      "created_by": 1000000,
      "deleted": false,
      "description": "",
      "entry_criteria": "Final terms agreed verbally or over email
Contract/legal document shared
Procurement/legal review in progress
Expected close date confirmed",
      "external_id": "default_stage_default_contract",
      "id": 1000005,
      "is_closed": false,
      "name": "Contract",
      "pipeline_id": 1000000,
      "stage_category": "Late Stage",
      "stage_order": 5,
      "updated_at": "2026-06-17T07:08:27.914900Z",
      "win_probability": 90
    },
    {
      "created_at": "2026-06-12T06:29:14.945165Z",
      "created_by": 1000001,
      "deleted": false,
      "description": "",
      "entry_criteria": "",
      "id": 1013909,
      "is_closed": false,
      "name": "contract done",
      "pipeline_id": 1000000,
      "stage_order": 6,
      "updated_at": "2026-06-17T07:08:28.708357Z",
      "win_probability": 95
    },
    {
      "created_at": "2026-06-16T08:29:17.834415Z",
      "created_by": 1000019,
      "deleted": false,
      "description": "",
      "entry_criteria": "First condition should be met",
      "id": 1014352,
      "is_closed": false,
      "name": "Tst",
      "pipeline_id": 1000000,
      "stage_category": "Early Stage",
      "stage_order": 7,
      "updated_at": "2026-06-17T07:08:29.553321Z",
      "win_probability": 0
    },
    {
      "created_at": "2026-02-02T12:30:18.388575Z",
      "created_by": 1000000,
      "deleted": false,
      "description": "",
      "entry_criteria": "Contract signed
Payment terms accepted / initial payment triggered
Deal officially marked won in CRM",
      "external_id": "default_stage_default_closed_won",
      "id": 1000006,
      "is_closed": true,
      "name": "Closed Won",
      "pipeline_id": 1000000,
      "stage_category": "Closed Won",
      "stage_order": 8,
      "updated_at": "2026-06-16T08:30:27.229736Z",
      "win_probability": 100
    },
    {
      "created_at": "2026-02-02T12:30:19.081123Z",
      "created_by": 1000000,
      "deleted": false,
      "description": "",
      "entry_criteria": "Customer explicitly declines OR goes unresponsive after defined follow-ups
Reason for loss captured (price, competitor, no decision, etc.)",
      "external_id": "default_stage_default_closed_lost",
      "id": 1000007,
      "is_closed": true,
      "name": "Closed Lost",
      "pipeline_id": 1000000,
      "stage_category": "Closed Lost",
      "stage_order": 9,
      "updated_at": "2026-06-16T08:30:27.584851Z",
      "win_probability": 0
    }
  ]
}

Pipeline found.

Was this page helpful?