---
title: "Pipeline groupé selon `group_by` (commercial|stage|client)."
method: GET
path: "/api/v1/opportunities/pipeline"
tags: ["CRM — Opportunités"]
---

# Pipeline groupé selon \`group_by\` (commercial|stage|client).

`GET /api/v1/opportunities/pipeline`

## Request

- Base URL: `https://erp.eyeot.fr/api/v1`
- URL: `https://erp.eyeot.fr/api/v1/api/v1/opportunities/pipeline`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Pipeline groupé selon `group_by` (commercial|stage|client).

    Réponse :
        {
          "group_by": "commercial",
          "period_days": 30,
          "groups": [
            {
              "group_key": "<commercial_id>",
              "group_label": "Alice Dupont",
              "total_amount": 12500.0,
              "currency": "EUR",
              "count_total": 5,
              "stages": {
                "prospect": {"count": 2, "amount": 5000},
                "qualified": {"count": 2, "amount": 5000},
                "won": {"count": 1, "amount": 2500},
                ...
              }
            },
            ...
          ]
        }

**Permissions requises** : `crm:read`

## Response `200`

Succès — payload `{data, meta}` (cf. API-GUIDE §3.1)

## Other responses

- `401`: JWT manquant, expiré ou révoqué.
- `402`: L'organisation n'a pas d'abonnement actif (paywall). Rediriger vers /activate.
- `403`: Permissions `module:action` insuffisantes pour cette route.
- `404`: Ressource introuvable (ou cross-tenant — équivalent à hidden).
- `429`: Trop de requêtes. Honorer le header `Retry-After` (secondes).

---

[API](https://skmtc.dev/eyeot/apis/eyeot-erp-api.md) · [All operations](https://skmtc.dev/eyeot/apis/eyeot-erp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eyeot/apis/eyeot-erp-api/revisions/42ab95222a89?raw)