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

# List Opportunity Statuses

> List available opportunity statuses for your tenant

List all custom opportunity statuses configured for your tenant. Use the returned status IDs with the [Update Opportunity](/api-reference/update-opportunity) endpoint.

## Response Fields

<ResponseField name="statuses" type="array">
  Array of status objects, ordered by `position`.
</ResponseField>

<ResponseField name="statuses[].id" type="string">
  Status UUID. Pass this as `status_id` when updating an opportunity.
</ResponseField>

<ResponseField name="statuses[].name" type="string">
  Display name (e.g. "Assigned", "Contacted", "Meeting Booked").
</ResponseField>

<ResponseField name="statuses[].color" type="string">
  Hex color code for UI display (e.g. `#3B82F6`).
</ResponseField>

<ResponseField name="statuses[].position" type="integer">
  Display order (0-based). Lower values appear first.
</ResponseField>

<ResponseField name="statuses[].is_terminal" type="boolean">
  Whether this status represents a final state (e.g. "Won", "Not Interested", "Archived").
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.clustr-ai.com/api/public/opportunity-statuses" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "statuses": [
        {
          "id": "8f652e61-edfa-4a8c-8763-cc4902dd386b",
          "name": "Assigned",
          "color": "#3B82F6",
          "position": 0,
          "is_terminal": false
        },
        {
          "id": "5566db32-2792-4162-852b-7db42af804fa",
          "name": "Contacted",
          "color": "#6366F1",
          "position": 1,
          "is_terminal": false
        },
        {
          "id": "cbfd0074-57bd-4fa7-a5fc-8bb5392b16c9",
          "name": "Meeting Booked",
          "color": "#06B6D4",
          "position": 3,
          "is_terminal": false
        },
        {
          "id": "7e4cc70e-2644-4b1e-9006-57222533dde4",
          "name": "Not Interested",
          "color": "#EF4444",
          "position": 5,
          "is_terminal": true
        }
      ]
    }
  }
  ```
</ResponseExample>