Skip to content
On this page

Overview

Cross-organization summary for the authenticated user.

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

GET /api/v1/overview/summary

Requires authentication (Bearer token) and the X-Organization-Id header.

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.

Responses

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

Example request

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

We use cookies and privacy-respecting analytics

We use essential cookies for authentication and privacy-respecting analytics (self-hosted, respects Do Not Track). No advertising or third-party tracking. Learn more in our Privacy Policy