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

# Get Deal Stages

> Retrieve all deal stages for managing deal pipeline and commission tracking

## Authentication

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.journeybee.io/api/v1/stages/lead-deal-stages" \
    -H "Authorization: Bearer your-api-key-uuid" \
    -H "Content-Type: application/json"
  ```
</CodeGroup>

## Response Schema

<ResponseField name="stages" type="array">
  Array of deal stage objects

  <Expandable title="Deal Stage Object">
    <ResponseField name="id" type="number">Stage ID</ResponseField>
    <ResponseField name="uuid" type="string">Stage UUID</ResponseField>
    <ResponseField name="label" type="string">Stage name</ResponseField>
    <ResponseField name="series" type="number">Stage order/sequence</ResponseField>
    <ResponseField name="phase" type="string">Stage phase: `discovery`, `negotiation`, `closed_won`, `closed_lost`</ResponseField>
    <ResponseField name="partner_type" type="string">Partner type association</ResponseField>
  </Expandable>
</ResponseField>

## Example Response

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": 1,
      "uuid": "deal-stage-uuid-123", 
      "label": "Proposal",
      "series": 1,
      "phase": "discovery",
      "partner_type": "referral",
    },
    {
      "id": 2,
      "label": "Negotiation",
      "series": 2, 
      "phase": "negotiation"
    },
    {
      "id": 3,
      "label": "Closed Won",
      "series": 3,
      "phase": "closed_won"
    }
  ]
  ```
</ResponseExample>

## Notes

* Requires API key with `read_access` permission
* Deal stages manage the sales pipeline from lead to close
* Phases determine commission calculation and reporting logic