---
title: "Get all stages associated with lead"
method: GET
path: "/leads/{id}/stages"
tags: ["Leads"]
---

# Get all stages associated with lead

`GET /leads/{id}/stages`

Get all stages associated with a lead by the ID provided, including information like amount of time spent in each stage.

## Path parameters

- `id` string, required

## Response `200`

Stages

- object
  - `meta` object — Information about the Nutshell instance making the request
    - `instanceId` string — The Nutshell instance ID
    - `siteId` string — Site ID for WebFX customers
    - `timeSpent` object[] — Array of time spent in each stage
      - `formatted` string — Formatted value
      - `prefix` string — Prefix to add to value
      - `suffix` string — Suffix to add to value
      - `value` number — Actual value
      - `unit` string — Unit of time
    - `stageset` Stageset
      - `id` string — The API ID of this entity, formatted {integer}-{entityType}
      - `name` string — The name of the pipeline
      - `default` boolean — Whether this is the default pipeline for new leads.
      - `canAccess` boolean — Whether the user can access the stageset based on the current Nutshell plan.
      - `status` integer — The status of the stageset. '1' for active, '2' for draft, '3' for retired
  - `stages` Stage[]
    - `id` string — The API ID of this entity, formatted {integer}-{entityType}
    - `name` string — The name of the stage
    - `description` string — The purpose of the stage
    - `position` integer — The order in which this stage appears in the pipeline
    - `activeAvatarUrl` string
    - `completeAvatarUrl` string
    - `incompleteAvatarUrl` string
    - `overdueAvatarUrl` string
    - `numSteps` number — The number of steps in this stage to move on to the next stage
    - `canAdvanceStage` boolean — Can we advance the lead to this stage?
    - `links` object[] — A list of related entity IDs
      - `stageset` string

---

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