Create Policyholder with Quote

An insurance quote is a cost estimate provided by the insurer. It is calculated by considering different options for coverage and showing the associated price of each.

Through the Casava Quotes API, you are able to generate quotes based on the insurance policy code you provide.

Create a policy holder from a quote request

POSThttps://channel.sandbox.casava.co/api/channel-service/v1/policyHolder/quote

Authorization

api_key

Header parameters

Body

application/json

list of policy tiers and details to include in quote generation

tierId*string

Id of selected policy tier

Example: "prdprcpln_61b6a0ggff"

firstnamestring

policy holder firstname

Example: "John"

lastnamestring

policy holder lastname

Example: "Doe"

addressstring

policy holder address

Example: "56 oregun street"

genderstring

policy holder gender

Example: "male"

email*string

policy holder contact email address

Example: "[e-mail]"

phone*string

policy holder contact phone number

Example: "0801829292"

salarynumber

Salary amount of the customer. Only required for Income Protection Policy, amount cannot be bellow 30,000.

Example: 90000

policyHolderNumberstring

optional policy holder identier, if not sent the system generates a unique number to identifier the policy holder.

Example: "123456789"

Response

201400

quote created successfully

Body

application/json

quoteId*string

unique identifier for a previously computed active quote

Example: "123456788"

quoteExpiryDate*string

Expiry date for the quote

Example: "2021-10-23"

policyCodestring

unique reference code of the insurance policy

Example: "1234567262"

policyHolderNumberstring

optional policy holder identier

Example: "123452829"

statusenum

allowed data type for the field

Example: "active"

pendingactiveissuedexpiried

amountnumber

total quote amount

Example: 200

installmentenum

allowed data type for the field

DAILYWEEKLYMONTHLYYEARLYONETIME

Request

JavaScriptCurlPython

const response = await fetch('https://channel.sandbox.casava.co/api/channel-service/v1/policyHolder/quote', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "tierId": "prdprcpln_61b6a0ggff",
      "email": "[e-mail]",
      "phone": "0801829292"
    }),
});
const data = await response.json();

Response

201400

{
  "quoteId": "123456788",
  "quoteExpiryDate": "2021-10-23",
  "policyCode": "1234567262",
  "policyHolderNumber": "123452829",
  "status": "active",
  "amount": 200,
  "installment": "DAILY"
}

Sample Request

{
  "tierId": "prdprcpln_61b6a0ggff",
  "firstname": "Daniel",
  "lastname": "Agoziem",
  "middlename": "Chizaram",
  "email": "[e-mail]",
  "phone": "07042274929",
  "address": "56 oregun street",
  "policyCode": "INCOMEPROTECT",
  "salary": 90000,
  "country": "Nigeria",
  "gender": "male",
  "dob": "10-09-1994"
}

Sample Response

{
    "statusCode": 201,
    "message": "policy holder and quote created successfully",
    "data": {
        "installment": "MONTHLY",
        "quoteId": "4801216546",
        "quoteExpiryDate": "2022-06-08T12:59:10.425Z",
        "amount": 250,
        "paymentReference": "casava_24471183",
        "status": "active",
        "policyCode": "INCOMEPROTECT",
        "policyHolderNumber": "20220509119621"
    }
}