Introduction
Riskcovry API kit is based on REST standard.
Our APIs has published resource-oriented URLs, that requires as input the form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes and authentication
The documentation here is meant to be indicative. For the Live APIs, please contact your Account manager with Riskcovry or contact support@riskcovry.com
Public APIs
Property APIs
Property Insurance is based on the workflow required as per Asset insurance guidelines. This is based on Asset calculation and Quotes based on the category of the Asset, Questions Flow and deducted logic for the same, Proposal details and the final purchase journey. The API kit also returns Policy status from the insurer.
Sub Categories with Establishments
Get Sub Categories
Request
https://{{base_url}}/api/partner/property/sub_categories_with_estabilshments?category_code=HOME
{URL params}
Response
{
[
{
"name": "Apartment",
"code": "24",
"featured": null,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Bunglow",
"display_text": "",
"description": "",
"examples": [],
"url": null,
"key": "Bunglow",
"code": "Bunglow",
"active": true,
"risk": 3
}
]
},
{
"name": "Bungalow",
"code": "25",
"featured": null,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Bunglow",
"display_text": "",
"description": "",
"examples": [],
"url": null,
"key": "Bunglow",
"code": "Bunglow",
"active": true,
"risk": 3
}
]
},
{
"name": "Chawl",
"code": "26",
"featured": null,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Bunglow",
"display_text": "",
"description": "",
"examples": [],
"url": null,
"key": "Bunglow",
"code": "Bunglow",
"active": true,
"risk": 3
}
]
},
{
"name": "Condo",
"code": "27",
"featured": null,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Bunglow",
"display_text": "",
"description": "",
"examples": [],
"url": null,
"key": "Bunglow",
"code": "Bunglow",
"active": true,
"risk": 3
}
]
},
{
"name": "Cottage",
"code": "28",
"featured": null,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Bunglow",
"display_text": "",
"description": "",
"examples": [],
"url": null,
"key": "Bunglow",
"code": "Bunglow",
"active": true,
"risk": 3
}
]
},
{
"name": "Duplex",
"code": "29",
"featured": null,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Bunglow",
"display_text": "",
"description": "",
"examples": [],
"url": null,
"key": "Bunglow",
"code": "Bunglow",
"active": true,
"risk": 3
}
]
},
{
"name": "Flat",
"code": "30",
"featured": null,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Bunglow",
"display_text": "",
"description": "",
"examples": [],
"url": null,
"key": "Bunglow",
"code": "Bunglow",
"active": true,
"risk": 3
}
]
},
{
"name": "Individual House",
"code": "31",
"featured": null,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Bunglow",
"display_text": "",
"description": "",
"examples": [],
"url": null,
"key": "Bunglow",
"code": "Bunglow",
"active": true,
"risk": 3
}
]
},
{
"name": "Kothi",
"code": "32",
"featured": null,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Bunglow",
"display_text": "",
"description": "",
"examples": [],
"url": null,
"key": "Bunglow",
"code": "Bunglow",
"active": true,
"risk": 3
}
]
},
{
"name": "Villa",
"code": "35",
"featured": null,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Apartment",
"display_text": "",
"description": "",
"examples": [],
"url": null,
"key": "Apartment",
"code": "Apartment",
"active": true,
"risk": 3
}
]
},
{
"name": "Housing Society",
"code": "427",
"featured": false,
"enabled": true,
"order": null,
"establishments": [
{
"name": "Housing Society",
"display_text": "Dwellings: Cooperative Society",
"description": "Are you a Housing Society? This is for you if you are a complex of residential apartments,\r\nbungalows etc.",
"examples": [
"Coop Housing Society",
" Residents Welfare Association",
" Housing Federation",
" Housing\r\nColony"
],
"url": null,
"key": "housing",
"code": "housing",
"active": true,
"risk": 2
}
]
}
]
}
Questions
Get Questions
Response to various logical questions leading to the right answers wrt. tenancy, floor levels and other risk parameters
Request
https://{{base_url}}/api/partner/property/questions?establishment_code=Bunglow
{URL params}
Response
[
{
"question": {
"id": 13,
"code": "13",
"title": "I am a",
"has_children": false,
"options": [
{
"value": "landlord",
"option_text": "Owner not living in the house",
"is_mandatory": false
},
{
"value": "tenants",
"option_text": "Tenant/Licensee",
"is_mandatory": false
},
{
"value": "owner",
"option_text": "Owner living in the house",
"is_mandatory": false
}
]
},
"options": [
{
"value": "landlord",
"option_text": "Owner not living in the house",
"is_mandatory": false
},
{
"value": "tenants",
"option_text": "Tenant/Licensee",
"is_mandatory": false
},
{
"value": "owner",
"option_text": "Owner living in the house",
"is_mandatory": false
}
],
"default_response": "tenants",
"status": false
},
{
"question": {
"id": 10,
"code": "10",
"title": "My house has",
"has_children": false,
"options": [
{
"value": "24 Hours Security",
"option_text": "24 Hours Security",
"is_mandatory": false
},
{
"value": "24 hours security with camera",
"option_text": "24 hours security with camera",
"is_mandatory": false
},
{
"value": "No Security",
"option_text": "No Security",
"is_mandatory": false
}
]
},
"options": [
{
"value": "24 Hours Security",
"option_text": "24 Hours Security",
"is_mandatory": false
},
{
"value": "24 hours security with camera",
"option_text": "24 hours security with camera",
"is_mandatory": false
},
{
"value": "No Security",
"option_text": "No Security",
"is_mandatory": false
}
],
"default_response": "",
"status": false
},
{
"question": {
"id": 11,
"code": "11",
"title": "My house is",
"has_children": false,
"options": [
{
"value": "Basement",
"option_text": "On the Ground floor",
"is_mandatory": false
},
{
"value": "No Basement",
"option_text": "On Higher floor",
"is_mandatory": false
}
]
},
"options": [
{
"value": "Basement",
"option_text": "On the Ground floor",
"is_mandatory": false
},
{
"value": "No Basement",
"option_text": "On Higher floor",
"is_mandatory": false
}
],
"default_response": "",
"status": false
},
{
"question": {
"id": 12,
"code": "12",
"title": "My house suffered damage due to Fire, Flood, Theft in last 3 years",
"has_children": false,
"options": [
{
"value": "yes",
"option_text": "Yes",
"is_mandatory": true
},
{
"value": "no",
"option_text": "No",
"is_mandatory": false
}
]
},
"options": [
{
"value": "yes",
"option_text": "Yes",
"is_mandatory": true
},
{
"value": "no",
"option_text": "No",
"is_mandatory": false
}
],
"default_response": "yes",
"status": true
},
{
"question": {
"id": 9,
"code": "9",
"title": "My house building is",
"has_children": false,
"options": [
{
"value": "50 years old and above",
"option_text": "30 years old and above",
"is_mandatory": true
},
{
"value": "< 50 years old",
"option_text": "Less than 30 years old",
"is_mandatory": false
}
]
},
"options": [
{
"value": "50 years old and above",
"option_text": "30 years old and above",
"is_mandatory": true
},
{
"value": "< 50 years old",
"option_text": "Less than 30 years old",
"is_mandatory": false
}
],
"default_response": "",
"status": false
}
]
Get Quote
Get Quote
Asset Calculators
Asset Calculators
Fetch Quote
Fetch Quote
Proposal Questions
Proposal Questions
Policy Status
Get Policy
Request
{{base_url}}/api/partner/property/get_policy_status?proposal_no=xxxxxx17df837c0797fd04f04f0135b6
{URL params}
Response
{
"status": "Active",
"proposal_no": "09xxxx17xx000x0797xx04xx4x01xxx6",
"ref_no": "201xxxx7x5xx9xx7xxxx4xxx8x",
"policy_no": "PROBUS0001xxxx",
"base_premium": 89.8,
"tax": 16.16,
"total_premium": 105.96,
"start_date": "14-10-2021",
"expiry_date": "13-10-2022",
"address": {
"id": 10909,
"unit_number": "111111",
"building_name": "XXXXXXX",
"area": "PQR",
"city": "bangalore",
"state": "Karndaka",
"zipcode": "560046",
"country": "india",
"policy_id": 1xxxx,
"created_at": "2021-10-13T17:58:51.000+05:30",
"updated_at": "2021-10-13T17:58:51.000+05:30"
},
"product_code": "GO_DIGIT_HOME",
"coi": null,
"carrier_policy_no": "D400xx80xx",
"insurance_company": "go_digit",
"product": {
"id": 5,
"code": "GO_DIGIT_HOME",
"name": "Go Digit Griha Raksh",
"average_rating": 0.0,
"total_ratings": 0,
"category": {
"id": 1,
"category_name": "Home",
"code": "HOME",
"created_at": "2018-05-03T15:11:26.000+05:30",
"updated_at": "2021-04-07T19:03:31.000+05:30",
"service_class": "Service",
"template_name": "hom-biz/Home",
"user_info_template": "",
"category_group": ""
},
"recalculation_status": ""
}
}
Retail Health APIs
Retail Health Insurance APIs
Retail Health APIs follow the workflow where User buys Health Insurance via Agent or by oneself. Health insurance journey starts with getting quotes from many Insurance carriers. Add-On Features are an essential part of all Health Insurances. The API kit also returns comaprison of features between various health products.
Get available products
Get Available Products
Get Quote with Specific Product
Get Quote with Specific Products
Get Quote Ref in order to process further
Request
{{base_url}}/api/partner/health/get_quotes
{
URL params
}
Response
{
"quote_id": "xxxxxxxxf3mffwpG46eV",
"fetch_ref": "xxxxxxxx-65ac-44ff-908e-499a7c6f414f",
"status": "Initiated"
}
Get Quote
Get Quote
Fetch Quote List
Fetch Quote List
Addons
Addons
APIs to get all the AddOns
Request
{{base_url}}/api/partner/health/addons
{
URL params
}
Response
{
[
{
"cover_code": "HEALTH_CHECK",
"cover_name": "Health Check",
"code": "HEALTH_CHECK",
"name": "Health Check",
"description": "Health medical check-up"
},
{
"cover_code": "CARE_HEART",
"cover_name": "Care Heart",
"code": "CARE_HEART",
"name": "Care Heart",
"description": "Heart Medical check-up"
}
]
}
Get overall retail health features
Get overall Retail Health Feature
Compare features
Compare Features
Combo Sachet APIs
Combo Sachet Purchase Journey
Combo Sachet Package is an innovation from Riskcovry. The best of breed polciies can be chosen and input to this API. Riskcovry maintains the package and individual policy details. The user is given an experience where the package is a single item for purchase.
Get premium
Get Premium
Premium is obtained based on the combination of products and policies chosen
Request
https://{{base-url}}/api/partner/sachets/combo_pricing.json
data={
"obj" : {
{
"products": [
{
"plan_code": "HA_PLAN_1",
"product_code": "HEALTH_ASSIST"
},
{
"plan_code": "PLAN-A",
"product_code": "HOSPICASH_3"
}
],
"dob": "01-01-1983"
}
}
}
Response
{
{
"base_premium": 326.27,
"tax": 58.73,
"premium": 385.0,
"products": [
{
"plan_code": "HA_PLAN_1",
"premium": 75.0,
"base_premium": 63.56,
"tax": 11.44,
"product_name": "Health Assist",
"product_code": "HEALTH_ASSIST",
"sum_assured": 50000,
"tenure": 1,
"carrier": "Global Assure Health"
},
{
"plan_code": "PLAN-A",
"premium": 310.0,
"base_premium": 262.71,
"tax": 47.29,
"product_name": "Hospital Cash",
"product_code": "HOSPICASH_3",
"sum_assured": 500,
"tenure": 1,
"carrier": "Kotak"
}
]
}
}
Purchase
Purchase API
Premium is obtained based on the combination of products and policies chosen.
Note: In situations where more than one customer contact needs to be added, use the Health APIs API.
Request
https://{{base-url}}/api/partner/sachets/combo_purchase.json
{
"proposer": {
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "Axxxx14xxx"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "Axxxx14xxx",
"address": {
"address_line_1": "Address Line 1",
"address_line_2": "Address Line 2",
"area": "xxxxx",
"city": "City",
"state": "Kerala",
"zipcode": "679322"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "HI",
"email": "axxx@xxxgix.in",
"phone_number": "9900117711",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"products": [
{
"plan_code": "HA_PLAN_1",
"product_code": "HEALTH_ASSIST"
},
{
"plan_code": "PLAN-A",
"product_code": "HOSPICASH_3"
}
],
"start_date": "12-01-2022",
"customer_ref": "xxxx1234",
"consent_type": "test",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
}
}
Response
{
{
"products": [
{
"product_name": null,
"product_code": "HEALTH_ASSIST",
"plan_code": null,
"sum_assured": "50000",
"start_date": "12-01-2022 00:00:00",
"expiry_date": "12-02-2022",
"base_premium": 63.55932203389831,
"tax": 11.440677966101696,
"premium": 75.0,
"policy_number": "RISKCOVRY00112333",
"carrier": "Global Assure Health",
"covers": "Health Assist",
"cover_codes": "Health_Assist_Cover_1",
"coi": "https://dssrylrxc4fuc.cloudfront.net/attachments/files/000/012/602/original/112068_2022-04-21.pdf?1650524310",
"customer_ref": "xxxx1234",
"status": "Active"
},
{
"product_name": null,
"product_code": "HOSPICASH_3",
"plan_code": null,
"start_date": "12-01-2022 00:00:00",
"expiry_date": "12-02-2022",
"base_premium": 262.712,
"tax": 47.2881,
"premium": 310.0,
"policy_number": "RISKCOVRY00112333",
"carrier": "Kotak",
"covers": "Hospital Cash",
"cover_codes": "HOSPICASH_Cover_2",
"coi": "https://dssrylrxc4fuc.cloudfront.net/attachments/files/000/012/603/original/policy_document.pdf?1650524312",
"customer_ref": "xxxx1234",
"status": "Active"
}
]
}
}
Get Policy
Get Policy
Premium is obtained based on the combination of products and policies chosen.
Note: In situations where more than one customer contact needs to be added, use the Health APIs API.
Request
https://{{base-url}}/api/partner/policies/get_policy_status.json?policy_no=RISKCOVRYXXXXYYYY
{
URL params
}
Response
{
'proposal_number': 'xxcfxxxe4xxxx51xx7xxxa3exxxxfaxx',
'paid_installments': 1,
'initial_policy_start_date': '21-04-2022 00:00:00',
'issued_at': '21-04-2022 00:00:00',
'ends_at': '20-04-2023 23:59:59',
'payment': {
'account_ref_no': '',
'paid_amount': 599.0,
'payment_mode': 'CD',
'completed_at': None,
'transaction_number': 'test',
'gateway_reference': 'test'
},
'combo_premium_details': {
'base_premium': None,
'tax': None,
'total_premium': None
},
'additional_info': {
'loan_tenure': '8',
'loan_tenure_unit': 'MONTHS',
'loan_account_no': 'DMI0019344838',
'loan_amount': '18384.00',
'loan_disbursal_date': '20/04/2022'
}
}
Bulk Sachet APIs
Bulk Sachet Purchase Journey
Bulk Sachet Package is largely used for mass upload from the backend. All bulk-purchased insurances are regularised at the platform. User can use the Policy Wallet any time to view his/her policies. Typically used for migration between systems.
Sachet bulk purchase
This API is used when many sachet policies need to be purchased at one go. Each request contains the Insured details, relevant information needed for the parameters such as dates, age etc and the nominee details.
Request
https://{{base-url}}/api/partner/sachets/bulk_purchase.json
{
"requests": [
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "pi",
"email": "sxx@gmail.com",
"phone_number": "9990900111",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "OH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "1",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "ki",
"email": "sxxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7700011011",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "OH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "2",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "kp",
"email": "sxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711100021",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "OH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "3",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "kp",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "HI",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "1",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "ki",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "OH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "2",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "ko",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711300011",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "CP",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "3",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxas",
"last_name": "kc",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "CH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "1",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "ks",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711300011",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "CH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "2",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "ki",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711144000",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "CH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "3",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "kp",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in
"phone_number": "7711144000",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "CA",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "1",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "kd",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711144000",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "CG",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "2",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "kg",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711144000",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "GH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "3",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "fp",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711144000",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "GH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "1",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "fp",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711144000",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "CK",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "2",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "gp",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711144000",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "HH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "3",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "ks",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711144000",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "CF",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "1",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "kg",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711144000",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "CG",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "2",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
},
{
"proposer": {
"title": "Mr",
"first_name": "sxxxxs",
"last_name": "jp",
"email": "xxx@gmail.com",
"phone_number": "9005000300",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "123412341234"
},
"insured": [
{
"title": "Mr",
"first_name": "Sxxgxxxxa",
"last_name": "Mxxhxxxn",
"email": "sxxgxxxxa@flxxxx.in",
"phone_number": "7711144000",
"dob": "01-01-1983",
"gender": "male",
"aadhar": "",
"address": {
"address_line_1": "AddressLine 1",
"address_line_2": "AddressLine 2",
"city": "City",
"state": "Kerala",
"zipcode": "679324"
}
}
],
"nominees": [
{
"title": "Mr",
"first_name": "Axxx",
"last_name": "CH",
"dob": "01-01-2003",
"gender": "male",
"relation": "Son"
}
],
"plan_code": "GLANCE_CORONA_1",
"product_code": "CORONA",
"start_date": "21-12-2020",
"customer_ref": "12345",
"transaction_ref": "3",
"consent_type": "OTP",
"consent_time": "21-05-2020 05:30:00",
"consent_data": "test",
"consent_request_time": "21-05-2020 05:30:00",
"additional_info": {
"test1": "test1"
}
}
]
}
}
Lend Pro APIs
Lend Pro (formerly Loan Protect)
Lend Pro is an innovation from Riskcovry for Loan Managers. The best of breed policies and rate can be chosen, played around and input to this API. Riskcovry maintains the package and individual policy details. The user is given an experience where the package is a single item for purchase.
Get premium
This is a public API used by Lenders integrated with their Loan Management Systems.
The functionality is that a manager of Lending comoany can decide the Loan insurance for the Loan taker based on parameters of Loan Amount, Loan type , Tenure, DOB, Interest rate that is convenient to the user.
Request
https://{{base-url}}//loan_protect/pricing.json?code=_68&loan_amount=25000&loan_type=Loan&tenure=12&dob=12-12-1994&interest_rate=8
URL Params
Loan Amount:
Loan Type:
tenure:
dob:
interest_rate:
Response
{
"premium": 192.79661016949154,
"age": 27,
"commission_rate": 29.046153846153842,
"total_premium": 227.50000000000003,
"gst": 34.70338983050848,
"total_commission": 56.0,
"covers": [
"Accidental Death",
"Critical Illness",
"Vector",
"Permanent Total Disability"
]
}
Purchase
This is a public API used by Lenders integrated with their Loan Management Systems. The functionality is where a manager of Lending company has played around with right pricing , tenure and interest rate for Laon customer prior to this exercise. She/he now invoked the purchase API to purchase the insurance policy
Request
https://{{base-url}}/loan_protect/purchase.json
{
URL params
}
{
"loan_number": "123454321",
"group_id": 6600,
"premium": 491.52542372881356,
"gst": 88.47457627118644,
"total_premium": 580,
"policies": [
{
"premium": 491.525,
"gst": 88.4746,
"total_premium": 580.0,
"policy_number": "dmi00111011",
"carrier": "Edelweiss",
"covers": "Critical Illness,Total Disability,Accidental Death,Vector",
"cover_codes": "CRITICAL_ILLNESS,TOTAL_DISABILITY,AccidentalDeath,VectorCover",
"coi": null,
"status": "Pending"
}
]
}
Leads APIs
Get All Leads - specify page details, partner ID and date range
Leads API is an extremely useful API for integrating with Marketing campaigns. Leads are potential buyers of insurance who showed interest. All leads can be generated by providing the date range and partner-code. Pagination is also available as a parameter.
get_leads
This is a public API used for obtaining all the leads from the partner system. Typically sued for retargeting and remarketing.
https://{{base-url}}//api/partner/leads?page=1&per_page=25&partner_user_id=&date_range=01/03/2022-25/03/2022&phone_number=
URL Params
page:
per_page:
partner_user_id:
date_range:
phone_number:
This is a public API used by Lenders integrated with their Loan Management Systems. The functionality is where a manager of Lending company has played around with right pricing , tenure and interest rate for Laon customer prior to this exercise. She or he now invoked the purchase API to purchase the insurance policy.
Request
https://{{base-url}}//api/partner/leads?page=1&per_page=25&partner_user_id=&date_range=01/03/2022-25/03/2022&phone_number=
URL Params
{
"leads": [
{
"session_token":"99y2ZT8drsR5QMVFoMny",
"product": "Retail Health",
"plan": "",
"proposal_number": null,
"retail_product": "Star Comprehensive Floater",
"name": "Vaxxxax R",
"proposer_name": "Vaxxxax R",
"first_insured_name": "Vaxxxax R",
"age": 29,
"phone_number": "7981118111",
"email": "vaxxxax.r@rixxcoxxx.com",
"lead_url": null,
"status": "",
"insurance_company": "Star Health and Allied Insurance",
"enquired_on": "30/03/2022 12:04 AM",
"is_break_in": null,
"break_in_status": null,
"break_in_reason": null,
"primary_address": {
"unit_number": null,
"building_name": "ABCDE",
"area": "XYZ123",
"city": "Banglore",
"state": "Karnataka",
"zipcode": "560047",
"country": null
},
"correspondence_address": {
"unit_number": null,
"building_name": "ABCDE",
"area": "XYZ123",
"city": "Banglore",
"state": "Karnataka",
"zipcode": "560047",
"country": null
},
"pin_code": null,
"uploaded_document": null,
"partner_user_id": null,
"partner_lead_status": null
}.... extends to many pages not included here
]
"total_elements": 68,
"total_pages": 3,
"current_page": "1",
"per_page": "25"
}
