Per-tenant health snapshot — balances, fee plan, ledger invariants (platform staff only)
The tenant's balance rollup by owner type, purpose and commodity, plus the one invariant a caller can check without holding the books: every commodity must net to zero across the whole ledger.
/v1/tenants/{tenantId}/summaryThe tenant's balance rollup by owner type, purpose and commodity, plus the one invariant a caller can check without holding the books: every commodity must net to zero across the whole ledger. invariants_ok is false and violations names the commodity when it does not. The deeper checks (entry sums, floors, checkpoints) belong to ledgerd verify, not here. Requires platform:manage; refuses platform_scope_only (403) and tenant_not_found (404).
Authorization
bearerAuth A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.
In: header
Path Parameters
uuidResponse Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/tenants/497f6eca-6276-4993-bfeb-53cbbbba6f08/summary"{ "tenant": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "currency": "string", "status": "string", "fees": { "payment": { "bps": 0, "flat": 0, "min_fee": 0, "max_fee": 0 }, "subscription": { "bps": 0, "flat": 0, "min_fee": 0, "max_fee": 0 }, "commission": { "bps": 0, "flat": 0, "min_fee": 0, "max_fee": 0 }, "p2p": { "bps": 0, "flat": 0, "min_fee": 0, "max_fee": 0 }, "topup": { "bps": 0, "flat": 0, "min_fee": 0, "max_fee": 0 }, "payout": { "bps": 0, "flat": 0, "min_fee": 0, "max_fee": 0 } }, "commission_mode": "deduct", "created_at": "2019-08-24T14:15:22Z" }, "rows": [ { "owner_type": "string", "purpose": "string", "commodity": "string", "balance": 0, "accounts": 0 } ], "invariants_ok": true, "violations": [ "string" ]}Provision a tenant with its system accounts (platform staff only)
Provisions a partner loop: the tenant's ledger is created first, then the tenant row, so the tenant id is minted alongside its books.
Whole-platform ledger view — every tenant's position and health (global admin only)
One row per tenant with its user count, 30-day movement, treasury float, outstanding liabilities and whether its books net to zero, plus totals per currency.