Covrzy APIs (1.0.0)

Download OpenAPI specification:Download

API documentation for Travel APIs and Merchant Quotes

Travel

Bind Policy

Bind Policy for requested passenger details

path Parameters
partner_id
required
string

Partner ID

header Parameters
X-API-Key
required
string
Default: your-default-api-key-value

API Key

Request Body schema: application/json
required

Bind Policy request payload

required
object
required
object
required
Array of objects

List of passengers on the trip with their details

Responses

Request samples

Content type
application/json
{
  • "tripDetails": {
    },
  • "policyDetails": {
    },
  • "passengerDetails": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "1",
  • "success": true,
  • "message": "Policies bound successfully for all passengers",
  • "data": {
    }
}

Get Policy

Get Policy for requested policy number

path Parameters
partner_id
required
string

Partner ID

header Parameters
X-API-Key
required
string
Default: your-default-api-key-value

API Key

Request Body schema: application/json
required

Get Policy request payload

policyNo
required
string

Unique number of this policy

bookingId
required
string

Booking ID of the travel

Responses

Request samples

Content type
application/json
{
  • "policyNo": "string",
  • "bookingId": "string"
}

Merchant Quote

Create a new quote

Create quote for the requested merchant cover

path Parameters
partner_id
required
string

Partner ID

header Parameters
X-API-Key
required
string
Default: your-default-api-key-value

API Key

Request Body schema: application/json
required

Quote creation request payload

insurers
required
Array of strings
Items Enum: "bajajAllianz" "iciciLombard"

List of insurer codes

correlationId
required
string

Correlation ID for tracking

policyStartDate
required
string <date>

Start date of the policy

typeOfPolicy
required
string
Enum: "New Business" "Renewal"

Type of policy

required
object
required
Array of objects
Array of objects

Responses

Request samples

Content type
application/json
{
  • "insurers": [
    ],
  • "correlationId": "string",
  • "policyStartDate": "2019-08-24",
  • "typeOfPolicy": "New Business",
  • "customerDetails": {
    },
  • "locationBasedRiskAndCoverPackages": [
    ],
  • "policyLevelAddOnCovers": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "success": true,
  • "message": "Quote created successfully",
  • "data": {
    }
}

Payments

Record a payment

Record a payment with UTR Number, Quote ID, Total Amount, Premium, Tax on Premium, and Correlation ID

path Parameters
partner_id
required
string

Partner ID

header Parameters
X-API-Key
required
string
Default: your-default-api-key-value

API Key

Request Body schema: application/json
required

Payment recording request payload

utrNumber
required
string

Unique Transaction Reference (UTR) number

userId
required
string

Encrypted User ID

quoteId
required
string

ID of the quote related to this payment

totalAmount
required
number

Total amount of the payment

premium
required
number

Premium amount for the policy

taxOnPremium
required
number

Tax applied to the premium

correlationId
required
string

Correlation ID for tracking the payment

insurerCode
required
string
Enum: "bajajAllianz" "iciciLombard"

The code of the insurer for which payment is to be made

Responses

Request samples

Content type
application/json
{
  • "utrNumber": "string",
  • "userId": "string",
  • "quoteId": "string",
  • "totalAmount": 0,
  • "premium": 0,
  • "taxOnPremium": 0,
  • "correlationId": "string",
  • "insurerCode": "bajajAllianz"
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "Payment recorded successfully",
  • "paymentId": "string",
  • "data": {
    }
}

KYC

Create KYC details

Store KYC details including PAN and GST files

path Parameters
partner_id
required
string

Partner ID

header Parameters
X-API-Key
required
string
Default: your-default-api-key-value

API Key

Request Body schema: multipart/form-data
required
user_id
required
string

Encrypted User ID

correlationId
required
string

Enter the Correlation ID that you got from the Payments API

name
required
string

Name of the insured user

email
required
string <email>

Email of the insured user

mobile_number
required
string

Mobile number of the insured user

gst_number
required
string

GST number of the business

pan_number
required
string

PAN number of the business

pan_document
required
string <binary>

PAN Document

gst_document
required
string <binary>

GST Document

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "message": "KYC Created successfully"
}

Policies

Get Policy Certificate

Download the policy certificate by providing the policy number and correlation ID

path Parameters
partner_id
required
string

Partner ID

header Parameters
X-API-Key
required
string
Default: your-default-api-key-value

API Key

Request Body schema: application/json
required

Request payload for downloading the policy certificate

policyNumber
required
string

The unique policy number

correlationId
required
string

Correlation ID for tracking the request

userId
required
string

Encrypted User ID

Responses

Request samples

Content type
application/json
{
  • "policyNumber": "string",
  • "correlationId": "string",
  • "userId": "string"
}

Cargo

Bind Cargo Delay Policy

Bind Cargo Delay Policy for the requested shipment details

path Parameters
partner_id
required
string

Unique identifier for the partner

header Parameters
X-API-Key
required
string
Default: your-default-api-key-value

API Key for authentication

Request Body schema: application/json
required

Bind Cargo Delay Policy request payload

transportMode
required
string
Enum: "air" "sea" "land"

Mode of transport used for cargo shipment

required
object

Details of the shipment being insured

customerName
required
string

Name of the customer purchasing the cargo insurance

customerCountry
required
string

Country code of the customer's location

customerEmail
required
string <email>

Email address of the customer for communication and policy documents

Responses

Request samples

Content type
application/json
{
  • "transportMode": "air",
  • "shipment": {
    },
  • "customerName": "Covrzy Test Customer",
  • "customerCountry": "US",
  • "customerEmail": "jeremy+covrzy@otonomi.ai"
}

Response samples

Content type
application/json
{
  • "status": "booked",
  • "amount": 74.8,
  • "policyId": "7b9c0d2a-34ef-41f9-bb10-123456789abc"
}

Get Cargo Delay Policy

Get Cargo Delay Policy for the requested policy number

path Parameters
partner_id
required
string

Partner ID

header Parameters
X-API-Key
required
string
Default: your-default-api-key-value

API Key

Request Body schema: application/json
required

Get Cargo Delay Policy request payload

policyNo
required
string

Unique number of this policy

consignmentId
required
string

Consignment ID related to the policy

Responses

Request samples

Content type
application/json
{
  • "policyNo": "string",
  • "consignmentId": "string"
}