---
title: "KPIs cross-org temps reel pour la \"Vue Groupe\" (Sprint +25 Phase 1)."
method: GET
path: "/api/v1/dashboard/group-summary"
tags: ["Tableaux de bord"]
---

# KPIs cross-org temps reel pour la "Vue Groupe" (Sprint +25 Phase 1).

`GET /api/v1/dashboard/group-summary`

## Request

- Base URL: `https://erp.eyeot.fr/api/v1`
- URL: `https://erp.eyeot.fr/api/v1/api/v1/dashboard/group-summary`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

KPIs cross-org temps reel pour la "Vue Groupe" (Sprint +25 Phase 1).

    Endpoint consomme par `<GroupDashboard>` (cf
    `frontend/src/features/dashboard/components/group-dashboard.tsx`)
    desormais affiche en onglet "Vue Groupe" de la page
    `/reports/group-consolidation`.

    Avant ce endpoint, le widget tombait en 404 -> affichait "—" partout
    (bug "champs de la vue groupe restent vides" reporte par user).

    Query params :
      - target_currency (default EUR)
      - period_start ISO date (default = today - 30j)
      - period_end ISO date (default = today)
      - organization_ids CSV optionnel (default = toutes memberships actives)

    RBAC : `finance:consolidate` (DAF a la perm, owner via `admin:all`
    bypass, commercial/magasinier/etc 403). Le check membership est
    applique a chaque org_id pour empecher un cross-org leak (cf
    `_resolve_org_ids` dans `api/v1/reports/routes.py`).

**Permissions requises** : `finance:consolidate`

## 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)
