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

# Listar funis de venda

> Retorna todos os funis de venda da organização com suas etapas.

## Endpoint

```
GET /v1/pipelines
```

**Escopo necessário:** `read:pipelines`

## Exemplo de requisição

```bash theme={null}
curl "https://api.socialsell.ai/v1/pipelines" \
  -H "Authorization: Bearer sk_live_..."
```

## Exemplo de resposta

```json theme={null}
{
  "data": [
    {
      "id": "664a1b2c3d4e5f6789012345",
      "name": "Funil Principal",
      "description": "Funil de vendas principal da equipe",
      "is_default": true,
      "is_active": true,
      "stages": [
        {
          "id": "664e1a2b3c4d5e6f78901230",
          "name": "Novo Lead",
          "order": 0,
          "color": "#6366F1",
          "win_probability": 10,
          "stalling_enabled": false,
          "stalling_days": null
        },
        {
          "id": "664e1a2b3c4d5e6f78901231",
          "name": "Qualificação",
          "order": 1,
          "color": "#8B5CF6",
          "win_probability": 30,
          "stalling_enabled": true,
          "stalling_days": 7
        },
        {
          "id": "664e1a2b3c4d5e6f78901232",
          "name": "Proposta enviada",
          "order": 2,
          "color": "#A78BFA",
          "win_probability": 60,
          "stalling_enabled": true,
          "stalling_days": 5
        },
        {
          "id": "664e1a2b3c4d5e6f78901233",
          "name": "Negociação",
          "order": 3,
          "color": "#7C3AED",
          "win_probability": 80,
          "stalling_enabled": true,
          "stalling_days": 3
        }
      ],
      "deals_count": 45,
      "won_count": 12,
      "after_won": null,
      "after_lost": null,
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-05-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "total": 2,
    "has_more": false
  }
}
```

## Objeto funil de venda

| Campo         | Tipo         | Descrição                 |
| ------------- | ------------ | ------------------------- |
| `id`          | string       | ID do funil               |
| `name`        | string       | Nome                      |
| `description` | string\|null | Descrição                 |
| `is_default`  | boolean      | Se é o funil padrão       |
| `is_active`   | boolean      | Se está ativo             |
| `stages`      | array        | Lista de etapas ordenadas |
| `deals_count` | integer      | Total de negócios         |
| `won_count`   | integer      | Negócios ganhos           |
| `after_won`   | object\|null | Ação após ganhar negócio  |
| `after_lost`  | object\|null | Ação após perder negócio  |

## Objeto stage

| Campo              | Tipo          | Descrição                                              |
| ------------------ | ------------- | ------------------------------------------------------ |
| `id`               | string        | ID da etapa — use em `stage_id` nos endpoints de deals |
| `name`             | string        | Nome da etapa                                          |
| `order`            | integer       | Posição na sequência (0 = primeira)                    |
| `color`            | string        | Cor hexadecimal                                        |
| `win_probability`  | integer       | Probabilidade de fechamento (0–100)                    |
| `stalling_enabled` | boolean       | Se alerta de estagnação está ativo                     |
| `stalling_days`    | integer\|null | Dias sem movimentação para alertar                     |