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

post

Authorizations

Header parameters

api_keyanyrequired

Body

tierIdstringrequired

Id of selected policy tier

Example: prdprcpln_61b6a0ggff

firstnamestringoptional

policy holder firstname

Example: John

lastnamestringoptional

policy holder lastname

Example: Doe

addressstringoptional

policy holder address

Example: 56 oregun street

genderstringoptional

policy holder gender

Example: male

emailstringrequired

policy holder contact email address

Example: [e-mail]

phonestringrequired

policy holder contact phone number

Example: 0801829292

salarynumberoptional

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

Example: 90000

policyHolderNumberstringoptional

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

Example: 123456789

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://channel.sandbox.casava.co/api/channel-service/v1/policyHolder/quote' \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "tierId": "prdprcpln_61b6a0ggff",
    "firstname": "John",
    "lastname": "Doe",
    "address": "56 oregun street",
    "gender": "male",
    "email": "[e-mail]",
    "phone": "0801829292",
    "salary": 90000,
    "policyHolderNumber": "123456789"
  }'

201

400

201

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

quote created successfully

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