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

api_key

api_keystringRequired

Header parameters

api_keyanyRequired

Body

application/json

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: [email protected]

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

201

quote created successfully

application/json

400

Validation error creating quote

application/json

post

/policyHolder/quote

HTTPcURLJavaScriptPython

POST /api/channel-service/v1/policyHolder/quote HTTP/1.1
Host: channel.sandbox.casava.co
api_key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 210

{
  "tierId": "prdprcpln_61b6a0ggff",
  "firstname": "John",
  "lastname": "Doe",
  "address": "56 oregun street",
  "gender": "male",
  "email": "[email protected]",
  "phone": "0801829292",
  "salary": 90000,
  "policyHolderNumber": "123456789"
}

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

Sample Request

{
  "tierId": "prdprcpln_61b6a0ggff",
  "firstname": "Daniel",
  "lastname": "Agoziem",
  "middlename": "Chizaram",
  "email": "[email protected]",
  "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"
    }
}