Retrieve Existing Quote
GET/v1/quote/:productCode/:quoteId
Retrieve Existing Quote
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
, renters
, season-interruption
, team-registration
, membership-insurance
]
Responses
- 200
- 201
- 400
- 401
- 422
Quote updated
- application/json
- Schema
- Example (from schema)
Schema
- 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
, ENDORSED
]
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
, renters
, season-interruption
, team-registration
, membership-insurance
]
For an endorsement, the change in price. A positive price change indicates that the price has increased and the customer will need to pay the difference. A negative price change indicates that the new policy is cheaper and that a refund is needed.
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",
"middle_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-09-04T16:02:42.754Z",
"expiration_date": "string",
"effective_date": "string",
"quote_date": "2024-09-04T16:02:42.754Z",
"product": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "event-participation-cancellation-insurance",
"friendly_name": "string",
"abbreviation": "string",
"description": "string",
"peril_heading": "string",
"perils": [
"string"
],
"descriptors": [
"string"
],
"promotional_header": "string",
"promotional_description": "string",
"promotional_icon": "string",
"accept_action_text": "string",
"decline_action_text": "string",
"legal_disclaimer": "string",
"privacy_policy_url": "string",
"terms_conditions_url": "string",
"additional_policy_purchase_email_message": "string"
},
"policy_attributes": {},
"endorsement_price_changes": 0,
"subscription_premium": {
"payments_required": 0,
"payment_amount": 0
},
"currency": "USD",
"total": 0,
"taxes_and_fees": [
{
"amount": 0,
"description": "string",
"type": "fee",
"included_in_premium": true,
"per_subscription_charge": true
}
],
"quote_id": "string",
"is_test": true,
"metadata": {},
"checkout_url": "string"
}
Quote created
- application/json
- Schema
- Example (from schema)
Schema
- 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
, ENDORSED
]
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
, renters
, season-interruption
, team-registration
, membership-insurance
]
For an endorsement, the change in price. A positive price change indicates that the price has increased and the customer will need to pay the difference. A negative price change indicates that the new policy is cheaper and that a refund is needed.
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",
"middle_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-09-04T16:02:42.755Z",
"expiration_date": "string",
"effective_date": "string",
"quote_date": "2024-09-04T16:02:42.755Z",
"product": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "event-participation-cancellation-insurance",
"friendly_name": "string",
"abbreviation": "string",
"description": "string",
"peril_heading": "string",
"perils": [
"string"
],
"descriptors": [
"string"
],
"promotional_header": "string",
"promotional_description": "string",
"promotional_icon": "string",
"accept_action_text": "string",
"decline_action_text": "string",
"legal_disclaimer": "string",
"privacy_policy_url": "string",
"terms_conditions_url": "string",
"additional_policy_purchase_email_message": "string"
},
"policy_attributes": {},
"endorsement_price_changes": 0,
"subscription_premium": {
"payments_required": 0,
"payment_amount": 0
},
"currency": "USD",
"total": 0,
"taxes_and_fees": [
{
"amount": 0,
"description": "string",
"type": "fee",
"included_in_premium": true,
"per_subscription_charge": true
}
],
"quote_id": "string",
"is_test": true,
"metadata": {},
"checkout_url": "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
}