Overview
Welcome to the MyInsureBank API Documentation. This API provides developers with a robust and secure way to integrate with MyInsureBank’s services, including:
- User authentication and authorization
- Creation and management of motor insurance policies
- Agent referral systems
- Seamless payment integration
With this API, you can streamline your insurance-related operations, automate policy creation, and offer users a smooth digital experience.
Whether you're building a new insurance platform or integrating with existing systems, our API is designed to be developer-friendly, well-documented, and secure.
MotorPolicy
POST Create Motor Policy
https://staging-api.myinsurebank.com/api/policies/motor
HEADERS
Accept: application/json
Body
{
"policyNo": "otilorPolicyNo",
"agentID": "1100308",
"branchID": "string",
"customerID": "string",
"productID": "MTP",
"entryDate": "2025-02-10T07:46:45.664Z",
"startDate": "2025-02-09T07:46:45.664Z",
"endDate": "2025-02-10T07:46:45.664Z",
"paymentProviderID": "string",
"paymentReferenceID": "string",
"insured": {
"title": "string",
"lastName": "string",
"firstName": "string",
"otherName": "string",
"gender": "MALE",
"email": "[email protected]",
"address": "string",
"phoneLine1": "08123456789",
"phoneLine2": "08123456789",
"isOrg": true,
"orgName": "string",
"orgRegNumber": "string",
"orgRegDate": "2025-02-09T07:46:45.664Z",
"password": "string",
"cityLGA": "string",
"stateID": "string",
"nationality": "string",
"dateOfBirth": "2025-02-09T07:46:45.664Z",
"kycType": "NOT_AVAILABLE",
"kycNumber": "string",
"kycIssueDate": "2025-02-09T07:46:45.664Z",
"kycExpiryDate": "2025-02-09T07:46:45.664Z",
"nextOfKin": {
"title": "string",
"lastName": "string",
"firstName": "string",
"otherName": "string",
"gender": "MALE",
"email": "[email protected]",
"address": "string",
"phoneLine1": "08123456789",
"phoneLine2": "08123456789"
}
},
"policySections": [
{
"certificateNo": "string",
"sectionSumInsured": 50000000,
"sectionPremium": 100000,
"vehicleRegNo": "string",
"vehicleTypeID": "VAN",
"vehicleUser": "string",
"engineNumber": "string",
"chasisNumber": "string",
"vehicleUsage": "PRIVATE",
"numberOfSeats": 0,
"stateOfIssue": "string",
"vehicleMake": "string",
"vehicleModel": "string",
"manufactureYear": 0,
"vehicleColour": "string",
"engineCapacityHP": "string",
"coverType": "COMPREHENSIVE"
}
]
}
Response
{
"policySections": [{
"vehicleRegNo": "string",
"vehicleTypeID": "VAN",
"vehicleUser": null,
"engineNumber": "string",
"chasisNumber": "string",
"vehicleUsage": "PRIVATE",
"numberOfSeats": 0,
"stateOfIssue": "string",
"vehicleMake": "string",
"vehicleModel": "string",
"manufactureYear": 0,
"vehicleColour": "string",
"engineCapacityHP": "string",
"coverType": "COMPREHENSIVE",
"certificateNo": null,
"sectionSumInsured": 0,
"sectionPremium": 0
}],
"policyNo": "UIC\/PIN\/MTP\/16957\/04\/25",
"agentID": "1100308",
"customerID": "HRO042503029",
"productID": "MTP",
"productClass": null,
"naicomID": null,
"entryDate": "2025-04-17T21:31:24.5484965+01:00",
"startDate": "2025-02-09T07:46:45.664Z",
"endDate": "2025-02-10T07:46:45.664Z",
"insured": {
"customerID": "HRO042503029",
"isOrg": false,
"orgName": null,
"orgRegNumber": null,
"orgRegDate": null,
"password": null,
"cityLGA": null,
"stateID": null,
"nationality": null,
"dateOfBirth": null,
"kycType": null,
"kycNumber": null,
"kycIssueDate": null,
"kycExpiryDate": null,
"nextOfKin": null,
"title": null,
"lastName": "string",
"firstName": "string",
"otherName": "string",
"gender": null,
"email": "[email protected]",
"address": "string",
"phoneLine1": "08123456789",
"phoneLine2": "08123456789"
}
}
Accident Policy
POST Create Accident Policy
https://staging-api.myinsurebank.com/api/policies/accident
HEADERS
Accept: application/json
Body
{
"policyNo": "otilorPolicyNo",
"agentID": "1100308",
"branchID": "BR001",
"customerID": "CUST001",
"productID": "ADP",
"entryDate": "2025-05-19T10:00:00Z",
"startDate": "2025-05-20T00:00:00Z",
"endDate": "2026-05-19T23:59:59Z",
"paymentProviderID": "PAY001",
"paymentReferenceID": "REF001",
"insured": {
"title": "Mr",
"lastName": "Doe",
"firstName": "John",
"otherName": "A",
"gender": "MALE",
"email": "[email protected]",
"address": "123 Main Street",
"phoneLine1": "08012345678",
"phoneLine2": "08087654321",
"isOrg": false,
"orgName": null,
"orgRegNumber": null,
"orgRegDate": null,
"password": "StrongPassword123",
"cityLGA": "Ikeja",
"stateID": "LA",
"nationality": "Nigerian",
"dateOfBirth": "1990-01-01",
"kycType": "NOT_AVAILABLE",
"kycNumber": "12345678901",
"kycIssueDate": "2020-01-01",
"kycExpiryDate": "2030-01-01",
"nextOfKin": {
"title": "Mrs",
"lastName": "Doe",
"firstName": "Jane",
"otherName": "B",
"gender": "FEMALE",
"email": "[email protected]",
"address": "123 Main Street",
"phoneLine1": "08023456789",
"phoneLine2": "08098765432"
}
},
"policySections": [
{
"certificateNo": "string",
"sectionSumInsured": 2000000,
"sectionPremium": 50000,
"coverType": "string",
"location": "Lagos",
"description": "Workplace personal accident cover",
"scopeofCover": "24-hour worldwide coverage",
"lienClauses": "None",
"members": [
{
"title": "Mr",
"lastName": "Smith",
"firstName": "Jake",
"otherName": "",
"gender": "MALE",
"email": "[email protected]",
"address": "456 Palm Avenue",
"phoneLine1": "08034567890",
"phoneLine2": ""
},
{
"title": "Miss",
"lastName": "Lee",
"firstName": "Anna",
"otherName": "Marie",
"gender": "FEMALE",
"email": "[email protected]",
"address": "789 Banana Street",
"phoneLine1": "08045678901",
"phoneLine2": "08012349876"
}
]
}
]
}
Response
{
"policySections": [{
"coverType": "string",
"location": "Lagos",
"description": "Workplace personal accident cover",
"scopeofCover": "24-hour worldwide coverage",
"lienClauses": "None",
"members": [{
"title": "Mr",
"lastName": "Smith",
"firstName": "Jake",
"otherName": null,
"gender": "MALE",
"email": "[email protected]",
"address": "456 Palm Avenue",
"phoneLine1": "08034567890",
"phoneLine2": null
}, {
"title": "Miss",
"lastName": "Lee",
"firstName": "Anna",
"otherName": "Marie",
"gender": "FEMALE",
"email": "[email protected]",
"address": "789 Banana Street",
"phoneLine1": "08045678901",
"phoneLine2": "08012349876"
}],
"certificateNo": null,
"sectionSumInsured": 0,
"sectionPremium": 0
}],
"policyNo": "UIC\/PIN\/ADP\/17063\/05\/25",
"agentID": "1100308",
"customerID": "HRO052503135",
"productID": "ADP",
"productClass": null,
"naicomID": null,
"entryDate": "2025-05-23T19:24:43.079438+01:00",
"startDate": "2025-05-20T00:00:00Z",
"endDate": "2026-05-19T23:59:59Z",
"insured": {
"customerID": "HRO052503135",
"isOrg": false,
"orgName": null,
"orgRegNumber": null,
"orgRegDate": null,
"password": null,
"cityLGA": null,
"stateID": null,
"nationality": null,
"dateOfBirth": null,
"kycType": null,
"kycNumber": null,
"kycIssueDate": null,
"kycExpiryDate": null,
"nextOfKin": null,
"title": null,
"lastName": "Doe",
"firstName": "John",
"otherName": "A",
"gender": null,
"email": "[email protected]",
"address": "123 Main Street",
"phoneLine1": "08012345678",
"phoneLine2": "08087654321"
}
}