Insurance Broker API Overview
Internal API for the Insurance Broker System, designed for Africa's insurance market. Supports client management, policy administration, claims processing, and TIRA-compliant reporting. Integrates with mobile money (M-Pesa, Tigo Pesa, Airtel Money) and supports Swahili/English interfaces.
Key API Endpoints
Authentication
Manage user authentication with endpoints like POST
/auth/login and POST /auth/refresh. Supports
bearer tokens and 2FA.
Client Management
Handle individual and corporate clients via POST
/clients/individual, POST /clients/corporate, and
GET /clients/:id.
Policy Management
Create, update, renew, or cancel policies with POST
/policies, POST /policies/:id/renew, and more.
Claims Processing
Process claims with POST /claims, POST /claims/:id/approve, and POST
/claims/:id/settle.
Quotation Management
Generate and convert quotations using POST /quotations and
POST /quotations/:id/convert-to-policy.
Document Generation
Export documents in PDF format with endpoints like GET
/policies/:id/certificate and GET
/quotations/:id/pdf.
Resources
- API Documentation - Full API reference and setup guide.
- Postman Collection - Download the collection for testing endpoints.
- TIRA Compliance Guide - Details on regulatory reporting and KYC/AML requirements.
- Mobile Money Integration - Instructions for integrating M-Pesa, Tigo Pesa, and Airtel Money.