---
title: "List Deal Stages"
method: GET
path: "/opportunity_stages"
tags: ["Deals"]
---

# List Deal Stages

`GET /opportunity_stages`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

<a href="https://knowledge.apollo.io/hc/en-us/articles/4415062467725-Deals-Overview" target="_blank">Deals</a> on Apollo help you track sales opportunities.<br><br>Use the List Deal Stages endpoint to retrieve information about every deal stage that's available in your team's Apollo account.<br><br>The `id` value for each deal stage can be used to set the stage when <a href="https://docs.apollo.io/reference/create-deal">creating a deal</a> or <a href="https://docs.apollo.io/reference/update-deal">updating a deal</a> via the Apollo API.<br><br>This endpoint requires a master API key. If you call the endpoint without a master key, you receive a `403` response. Check out <a href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a> to learn how to create a master key.

## Response `200`

200

- object
  - `opportunity_stages` object[]
    - `id` string
    - `team_id` string
    - `name` string
    - `display_order` integer
    - `forecast_category_cd` string
    - `is_won` boolean
    - `is_closed` boolean
    - `probability` integer
    - `description` string
    - `salesforce_id` string
    - `is_meeting_set` unknown
    - `opportunity_pipeline_id` string
    - `is_editable` unknown
    - `type` string

## Other responses

- `401` — 401
- `403` — 403
- `429` — 429

---

[API](https://skmtc.dev/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.dev/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/revisions/c715a05fa6e2/schema)