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

            Copy
        

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"
    }
  ]
}
            
            Copy   
            

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"
    }
}
        
            Copy