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

# Etapas del pipeline

> Lee la configuración del pipeline de la organización.

Las etapas son las columnas configurables del tablero de leads. Cada organización define las suyas; este endpoint te permite descubrirlas en runtime para que tu integración pueda enrutar leads a la etapa correcta por nombre.

## `GET /pipeline/stages`

**Scope:** `leads:read`. Lista las etapas del pipeline de la organización en orden de visualización.

### Request

```bash theme={null}
curl https://panel.flowestate.app/api/v1/pipeline/stages \
  -H "Authorization: Bearer fe_k_tu_key_aqui"
```

### Response 200

```json theme={null}
{
  "data": [
    {
      "id": "stage_...",
      "name": "Nuevo",
      "color": "#0ea5e9",
      "order": 0,
      "stageKind": "open",
      "systemKey": "new",
      "createdAt": "2025-10-01T12:00:00.000Z",
      "updatedAt": "2026-01-15T18:00:00.000Z"
    },
    {
      "id": "stage_...",
      "name": "Contactado",
      "color": "#a855f7",
      "order": 1,
      "stageKind": "open",
      "systemKey": "contacted",
      "createdAt": "2025-10-01T12:00:00.000Z",
      "updatedAt": "2025-10-01T12:00:00.000Z"
    }
  ]
}
```

### Campos

| Campo       | Descripción                                                                                                                                      |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`        | UUID. Úsalo en `POST /leads` y `PUT /leads/{id}` como el campo `stageId`.                                                                        |
| `name`      | Nombre de display en el panel. Puede estar localizado o personalizado por la organización.                                                       |
| `color`     | Color hex usado por el tablero del panel.                                                                                                        |
| `order`     | Orden de visualización. Números más bajos van primero.                                                                                           |
| `stageKind` | Bucket del ciclo de vida: `open`, `won`, `lost`.                                                                                                 |
| `systemKey` | Clave opcional que matchea con una de las etapas del sistema (`new`, `contacted`, etc.). Puede ser `null` para etapas totalmente personalizadas. |

<Tip>Usa `systemKey` si necesitas detectar la etapa canónica. Usa `id` cuando necesites enrutar un lead a una columna específica.</Tip>