Aller au contenu

Overview

Cross-organization summary for the authenticated user.

Cross-org bird's-eye summary (per-currency rollups)

GET /api/v1/overview/summary

Nécessite une authentification (jeton Bearer) et l’en-tête X-Organization-Id.

Read-only cross-org view (Epic #565). Returns per-org cards plus per-currency rollups (revenue / expenses / outstanding) over the orgs the caller may view.

  • User-scoped (first-party) tokens fan over ALL of the user's memberships.
  • Org-scoped tokens (API/MCP, organization API tokens) are restricted to their own org.
  • An org is included only where the user holds reports.view in that org — not mere membership.
  • No FX conversion: figures are grouped by currency; per-org figures use the org's own currency (ISO-4217). Amounts are decimal strings.

This namespace is intentionally separate from the per-org endpoints (no scope=all flag) so single-org endpoints stay strictly single-org. The active-org X-Organization-Id header does NOT apply here.

Réponses

Statut Description
200 Per-currency rollups and per-org cards.

Exemple de requête

curl -X GET "https://kworia.com/api/v1/overview/summary" \
  -H "Authorization: Bearer {{access_token}}" \
  -H "X-Organization-Id: {{organization_id}}" \
  -H "Accept: application/json"

Nous utilisons des cookies et des analyses respectueuses de la vie privée

Nous utilisons des cookies essentiels pour l'authentification et des analyses respectueuses de la vie privée (auto-hébergées, respectent Do Not Track). Aucun suivi publicitaire ou tiers. En savoir plus dans notre Politique de confidentialité