> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Deal Stages

> Retrieve all stored pipeline and stage definitions

`GET /deal-stages`

Returns all pipelines and their stages stored in Recotap for your team. Returns the full catalog in a single response with no pagination.

```bash theme={null}
curl "https://eapi.recotap.com/api/v1/deal-stages" \
  -H "X-Api-Key: your-api-key-here"
```

**Response `data`**

```json theme={null}
[
  {
    "pipelineId": "smb-pipeline",
    "pipelineLabel": "SMB Sales",
    "stages": [
      { "stageId": "s1", "stageLabel": "Prospecting" },
      { "stageId": "s2", "stageLabel": "Proposal Sent" },
      { "stageId": "s3", "stageLabel": "Closed Won" },
      { "stageId": "s4", "stageLabel": "Closed Lost" }
    ]
  }
]
```

| Field           | Description                                                                  |
| --------------- | ---------------------------------------------------------------------------- |
| `pipelineId`    | Your system's pipeline ID as pushed via [Push Deal Stages](push-deal-stages) |
| `pipelineLabel` | Display name of the pipeline                                                 |
| `stages`        | All stages for this pipeline in the order they were pushed                   |