One API. 12+ insurance products. Sandbox included.
Built for Nigeria and Africa.
Every insurance product follows the same three-step flow — register the customer once, price any product, issue the policy.
Register the insured person with prfl entity (SR05). Idempotent by email — call once per customer, reuse across all products.
Call dump ipck_{product}*PRMM (SR10) to get a live premium quote for any product. No commitment required.
Call entt_{cid}: insure (SR15). Poll SR20 for the certificate URL or policy number. Policy is live.
// POST https://octamile-api.azurewebsites.net { "userInfo": { "id": "YOUR_PARTNER_ID", "athrzt": { "id": "AUTH_ID", "key": "AUTH_KEY" } }, "cmmnd": { "cmmnd": "dump ipck_vhcl-cmpr-1111*PRMM", "seed": { "vehicleValue": 3000000, "insrncDrtn": "1y" } } } // Response { "exctnFdbck": { "id": 75, "id_v4": 200 }, "prmm": 75000 // premium in kobo }
All requests go to a single POST endpoint. The cmmnd.cmmnd field routes to the right handler. HTTP always returns 200 — check exctnFdbck.id: 75 = success, 55 = error.
From motor and health to marine and lending — all products share the same request structure and authentication.
TPRT + Comprehensive. Live NSIA pricing in real time.
AXA Mansard HMO plans with hospital network lookup.
SanlamAllianz. Individual and family plans. Multi-destination.
NSIA + UIC marine cargo certificates for shipments.
UIC GIT cover. Departure and arrival datetime-based pricing.
NSIA All Risk and Fire & Burglary for assets and premises.
NSIA PA. Sum insured, beneficiary, and cover period.
NSIA. Business type and sum insured. 1-year cover.
NSIA. Profession-based cover for licensed practitioners.
Octamile self-issued. Instant approval and policy number.
Flat-rate cover. 6-month or 1-year terms.
Loan repayment guaranty. Covers default for lenders.
No separate endpoints per product. No separate auth per insurer. One integration covers the full insurance stack.
View API ReferenceOne POST URL for every product and action. The cmmnd.cmmnd field routes to the right handler — no per-product URL to manage.
Toggle between test and live with set env_test / set env_live. Test mode never hits a real insurer — demo certs returned instantly.
Register a customer once with SR05. The returned consumer ID is reused across all products — no re-submission of KYC data per policy.
SR20 returns the certificate URL, policy number, or base64 document as soon as the insurer approves. No webhooks required.
NIID vehicle lookup (SR_ENRCH) returns registration, make, model, and ownership details from the Nigeria Insurance Industry Database.
All products are underwritten by licensed Nigerian insurers — NSIA, AXA Mansard, SanlamAllianz, UIC. Fully compliant distribution.
We'll get you set up with sandbox credentials and walk you through your first integration.
Request API Access Read the DocsAlready have credentials? View the API reference →
