Batch Quote
POST/v1/quote/:productCode/batch
Creates multiple quotes in a single request. All quotes must be of the same product type.
Request
Path Parameters
Possible values: [event-participation-cancellation-insurance
, event-host-liability
, event-host-cancellation
, pet-insurance
, shipping
, collectibles
, medsaver
, gap-medical
, regsaver
, travel
, tuition
, registration-cancellation
, ticket-refund
, season-interruption
, team-registration
]
- application/json
Body
arrayrequired
- Array [
- ]
customer object
2-character state code. Either state or postal_code is required when requesting a quote.
Possible values: >= 2 characters
and <= 2 characters
, [US
, CA
]
Default value: US
2-character country code
Either state or postal_code is required when requesting a quote.
metadata object
Reference an existing quote. Only required if attempting to update an existing quote.
This field overrides the partner associated with the policy. This is not required as we typically retrieve the partner information off of the provided credentials.
Default value: false
Send an email to the customer with the quote and option to purchase. Not required.
Responses
- 200
- 400
- 401
- 422
Batch Quotes Created
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- Policy_PolicyAttributes_
- BatchError
- Array [
- ]
- Array [
- ]
- ]
policy_holder object
customer object
state_object object
state object
Possible values: >= 50
The premium amount of the policy. This is typically considered a sub-total. Use total
for charging payment methods and displaying amounts to the user.
policy_documents object[]
Possible values: [POLICY
, CERTIFICATE_OF_INSURANCE
, OTHER
]
Possible values: [ACTIVE
, QUOTED
, EXPIRED
, PENDING_CANCELLATION
, CANCELED
, PENDING
, REQUIRES_PAYMENT
, BIND_FAILED
]
product object
Possible values: [event-participation-cancellation-insurance
, event-host-liability
, event-host-cancellation
, pet-insurance
, shipping
, collectibles
, medsaver
, gap-medical
, regsaver
, travel
, tuition
, registration-cancellation
, ticket-refund
, season-interruption
, team-registration
]
subscription_premium object
If this policy supports being billed as a monthly subscription instead of a one-time fee, this field will be present
The number of monthly payments required for this subscription
The monthly premium to be paid for this subscription
Possible values: [USD
, CAD
]
Total cost of the policy in cents. This is the amount that should be displayed and charged during checkout if the user accepts the insurance purchase.
taxes_and_fees object[]
Possible values: [fee
, tax
]
metadata object
[
{
"policy_holder": {
"first_name": "string",
"last_name": "string",
"email_address": "string",
"phone_number": "string",
"customer": {
"email_address": "user@example.com"
},
"street": "string",
"city": "string",
"state_object": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"abbreviation": "string",
"country": "string",
"default_timezone_offset": "string"
},
"state": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"abbreviation": "string",
"country": "string",
"default_timezone_offset": "string"
},
"postal_code": "string",
"country": "string"
},
"premium_amount": 0,
"policy_number": "string",
"policy_documents": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"master_policy_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"policy_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"document_type": "POLICY",
"storage_bucket": "string",
"storage_key": "string"
}
],
"policy_status": "ACTIVE",
"issued_date": "2024-05-16T17:44:31.144Z",
"expiration_date": "string",
"effective_date": "string",
"quote_date": "2024-05-16T17:44:31.144Z",
"product": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "event-participation-cancellation-insurance",
"friendly_name": "string",
"abbreviation": "string",
"promotional_header": "string",
"promotional_description": "string",
"accept_action_text": "string",
"decline_action_text": "string",
"peril_heading": "string",
"perils": [
"string"
],
"descriptors": [
"string"
],
"promotional_icon": "string",
"legal_disclaimer": "string",
"privacy_policy_url": "string",
"terms_conditions_url": "string",
"additional_policy_purchase_email_message": "string"
},
"policy_attributes": {},
"subscription_premium": {
"payments_required": 0,
"payment_amount": 0
},
"currency": "USD",
"total": 0,
"taxes_and_fees": [
{
"amount": 0,
"description": "string",
"type": "fee"
}
],
"quote_id": "string",
"is_test": true,
"metadata": {},
"checkout_url": "string"
},
{
"error": "string"
}
]
Bad request was sent, most likely from a missing parameter.
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "string",
"error_code": "string",
"message": "string",
"status": 0
}
Either x-api-client-id
or Authorization
header must be provided.
The quote or offer no longer exists but is either a pending or active policy.
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "string",
"error_code": "string",
"message": "string",
"status": 0
}