Get the ZFA house wallet summary

GET 
/admin/zfa-house/wallet

Returns the current balance + lifetime totals for the ZFA institutional wallet. Direct-channel commissions credit here after approval; finance reconciles this against ZFA's operating account.

Request

Responses

200

HouseWallet record.

401

Missing or invalid access token.

403

Caller lacks zfa_house:wallet:read.

429

Rate limit exceeded. Global default is 120 requests/minute per IP; auth-flow, OTP, self-registration, WebAuthn, IRA lookup, and public-lead endpoints carry tighter per-endpoint limits. Retry after the delay indicated by the Retry-After header.

Response Headers

Retry-After

Seconds to wait before retrying.

500

Unhandled server error. The response carries a meta.requestId correlator you can hand to platform operations to trace the failure through structured logs and the hash-chained audit trail. Retry with the same Idempotency-Key header if the endpoint accepts idempotency.