Brokerage Admin API

All endpoints in this section require broker role.

Compliance Queue


GET /api/brokerage/compliance-queue
Authorization: Bearer <jwt>

Returns deals with compliance_state = 'in_review', sorted by submission date.

Equity Queue


GET /api/brokerage/equity-queue
Authorization: Bearer <jwt>

Returns pending equity grant requests awaiting broker approval.


POST /api/brokerage/equity/[grant_id]/approve
POST /api/brokerage/equity/[grant_id]/reject

Finance Dashboard


GET /api/brokerage/finance
Authorization: Bearer <jwt>

Returns FinSummary:


{
  "total_gci": 245000.00,
  "total_brokerage_cut": 73500.00,
  "deals_closed": 31,
  "active_agents": 12,
  "top_agent": { "id": "uuid", "name": "Sarah Chen", "ytd_gci": 62000 }
}

Audit Trail Export


GET /api/brokerage/audit-trail/export?format=csv
Authorization: Bearer <jwt>

Exports a full audit log of all deal events, stage transitions, compliance actions, and commission records.

Brokerage Settings


GET  /api/brokerage/settings
PATCH /api/brokerage/settings
Authorization: Bearer <jwt>

Patchable: agent_split, cap_amount, elite_cap_amount, post_cap_rate, brokerage_name, abn