Composite OpenAPI 3.0 specifications — one per feature group. Import into Postman, Insomnia, Swagger UI, or generate a client.
Pick only the groups you need — each spec stands alone. Every client runs on an
edition: non_commercial covers billing, payer routing and patient payments;
commercial adds the revenue engine, financing, the NHIS ClaimIt tracker, agnostic payer tabs and the audit ledger.
Commercial-only endpoints return 402 upgrade_required otherwise. Check your own entitlement with
GET /api/v1/bills/edition; move a client between editions with the Master Control API.
| Header | Who | Scope |
|---|---|---|
| x-api-key | Clinic / hospital (EMR) | Their own bills, payments, claims |
| x-payer-key | Insurer / corporate payer | Claims addressed to them |
| x-console-key | IT lead | Their own organisation only |
| x-platform-key | SaaS owner | Whole deployment |
Send Idempotency-Key on authorise and financing calls so a retry never double-executes.