{
        "renew": false,
        "send_customer_notification": true,
    }

​
activation_metadata

Metadata regarding policy activation conditions. 
    {
        "renew": false,
        "send_customer_notification": true,
    }

renewboolean
If true, indicates that this insurance policy should automatically renew at the end of each default year. The renewal duration is set to the selected tenure at the time of purchase, hence, for a Two-year policy at purchase, at the end of the first two years, the system automatically renews it for another two year duration.
send_customer_notificationboolean
Indicates if we should notify the customer of the policy purchase request. This gives merchants’ control over notification policy, should they decide to send the customer a notification from their end. We however, only send information regarding a successful purchase, such as transactionId, the customer information along with timestamps of purchase. Think of it as a receipt.

​
additional_information

As with Quotes, data are captured differently according to the insurance product_type. Below are list of definitions with an example for each of them.

​
Auto Insurance

makestring =100 characters
Represents the vehicle brand.
modelstring =100 characters
Represents the vehicle model.
ownerstring
Full-name of the vehicle owner, as registered with the government.
valuedecimal >= 2,000,000
Market-value of the vehicle.
yeardate
Year of vehicle registration.
usecasestring enum: [private, commercial]
Indicates if vehicle is used for private or commercial purposes.
vehicle_typestring
Category of the vehicle (e.g saloon, SUV, light_truck, heavy_truck, heavy_duty_truck).
chassis_numberstring
Unique-identifier of the chassis plate as provided by the manufacturer.
engine_numberstring
Unique engine identifier.
registration_numberstring
Official license plate registration number.
{ 
    "make": "Toyota", 
    "model": "Camry", 
    "value": 2500000, 
    "owner": "John Doe", 
    "year": "2020-01-01", 
    "usecase": "private", 
    "vehicle_type": "SUV", 
    "engine_number": "ENG123456789", 
    "chassis_number": "CHS987654321", 
    "registration_number": "ABC123XYZ" 
}

​
Device Insurance

makestring
Device manufacturer brand e.g Apple, HP or Samsung.
modelstring
Specific-model (e.g S25, or iPhoneX).
valuestring
Market-value of the device insured.
serial_numberstring
Device serial number as assigned by the manufacturer.
imeistring
International Mobile Equipment Identity (mandatory for mobile devices).
device_typestring
Category of the device in question (e.g pos, phone, tablet, etc).
{
    "make": "Apple",
    "model": "iPhone 15 Pro",
    "value": "1600000",
    "serial_number": "SN1234567890",
    "imei": "IMEI0987654321",
    "device_type": "phone"
}

​
Personal Accident Insurance

occupationstring
The applicant’s occupation.
risk_levelstring enum: [Low, Medium, High]
Risk category based on occupation.
occupation_risk_detailsstring enum: [office, field, remote]
Additional details regarding the occupational risk.
{
    "occupation": "Construction Worker",
    "risk_level": "High",
    "occupation_risk_details": "field"
}

​
Home Insurance

property_valuedecimal
Estimated market-value of property.
stationary_items_valuedecimal
Estimated value of immovable items.
mobile_items_valuedecimal
Estimated value of movable items.
locationstring
Location (Format: State, Country).
fire_protectionboolean
Indicates if fire safety measures are installed.
security_detailsobject
Additional security information (e.g alarm systems, cctv, etc).

​
Shipment (Cargo) Insurance

originating_portstring
Port where the shipment originated.
destination_portstring
Destination port of the shipment.
currencystring
Currency used for the transaction (e.g USD, NGN, EUR).
bank_namestring
Name of the bank facilitating the transaction.
invoice_numberstring
Unique invoice number for the shipment.
cac_numberstring
Corporate Affairs Commission registration number of the responsible entity.
tin_numberstring
Tax Identification Number.
lc_numberstring
Letter of Credit number associated with transaction.
cargostring
Detailed description of cargo or shipment.
{ 
    "originating_port": "Lagos Port", 
    "destination_port": "Apapa Port", 
    "currency": "NGN", 
    "bank_name": "First Bank", 
    "invoice_number": "INV-123456", 
    "cac_number": "CAC987654", 
    "tin_number": "TIN123456", 
    "lc_number": "LC654321", 
    "cargo": "Electronics shipment including laptops and smartphones." 
}