Sign-In

Your Cart

Create Your Account

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.

Motor Policy

POST Create Motor Policy

Endpoint
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": "user@example.com",
    "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": "user@example.com",
      "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": "user@example.com",
    "address": "string",
    "phoneLine1": "08123456789",
    "phoneLine2": "08123456789"
  }
}
}

Accident Policy

POST Create Accident Policy

Endpoint
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": "john.doe@example.com",
    "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": "jane.doe@example.com",
      "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": "jake.smith@example.com",
          "address": "456 Palm Avenue",
          "phoneLine1": "08034567890",
          "phoneLine2": ""
        },
        {
          "title": "Miss",
          "lastName": "Lee",
          "firstName": "Anna",
          "otherName": "Marie",
          "gender": "FEMALE",
          "email": "anna.lee@example.com",
          "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": "jake.smith@example.com",
        "address": "456 Palm Avenue",
        "phoneLine1": "08034567890",
        "phoneLine2": null
      },
      {
        "title": "Miss",
        "lastName": "Lee",
        "firstName": "Anna",
        "otherName": "Marie",
        "gender": "FEMALE",
        "email": "anna.lee@example.com",
        "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": "john.doe@example.com",
    "address": "123 Main Street",
    "phoneLine1": "08012345678",
    "phoneLine2": "08087654321"
  }
}
}