# List stages

`GET https://api.cademi.com.br/api/v3/automations/diamond/{diamond_id}/stages`

Operation ID: `diamonds.stages.list` · API v3

Returns all eleven stages of the Diamond, in order. The set of stages is fixed: stages cannot be created or deleted.

Required permissions: `diamonds.read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `diamond_id` | path | string | yes |  |

## Responses

### 200

Returns the stages of the Diamond.

Body: `data`: array of Stage.

Fields of Stage:

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string, one of `lead`, `class_1_not_initiated`, `class_1_concluded`, `class_2_not_initiated`, `class_2_concluded`, `class_3_not_initiated`, `class_3_concluded`, `checkout_not_initiated`, `checkout_initiated`, `checkout_abandoned`, `won` | yes |  |
| `interval_minutes` | integer or null | yes | Wait time in minutes, or null for stages that are not scheduled. |
| `kind` | string, one of `lead`, `class`, `checkout`, `won` | yes |  |
| `lesson_id` | string or null | yes | Public ID of the stage lesson, with the les_ prefix, or null for stages that are not tied to a lesson. |
| `memberships_count` | integer | yes |  |
| `object` | string, one of `stage` | yes |  |
| `position` | integer | yes | Position of the stage in the Diamond sequence, from 0 to 10. |
| `trigger_id` | string or null | yes | Public ID of the stage trigger, with the trg_ prefix. |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 404

The Diamond was not found or is not accessible with the current credentials.

Body: Error.

### 409

Diamond automations are not enabled for the current account.

Body: Error.

Full schema: https://cademi.dev/openapi/v3.json