Retrieve Single Quote

post

https://api.sandbox.getspot.com/api/v1/quote

Request a quote for Spot coverage to render at checkout. This endpoint is specific to single-item carts and scenarios where all items should be bundled under one coverage.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Before implementing quoting, align with Spot on the inputs that will be provided for the required fields below, as these values are used to route quotes to the appropriate offer within Spot’s system.

productId, productDuration, productType, isPartialPayment

Body Params

currencyCode

string

enum

required

The currency used to purchase the product.

metadata

object

Optional key-value pairs providing context about the customer, business segment, and purchase channel. Used to segment performance and optimize offer targeting. Supports any string key-value pairs, with common fields including segment, operator, channel, and consumerId.

productPrice

number

required

The price of the product being sold in the base currency.

productType

string

required

The product type being sold (one of "Pass", "Trip", "Registration").

productDuration

string

required

The product type being sold (one of "Daily", "Seasonal", "Trip", "Event").

productId

string

required

The unique identifier for the product being sold.

cartId

string

required

A unique identifier for a cart that groups all quotes from a single checkout flow. A consumer may have multiple cartIds across sessions.

cartName

string

required

The name displayed on the customer's coverage tile in their Spot account. Example: Utah Desert Festival

cartItemId

string

A unique identifier for the cart item that distinguishes it from other items in the same cart.

productName

string

required

The name or description of the product being sold. Example: "Early Bird"

participantDescription

string

Appended to the product name in the claims flow to help identify the coverage. Example: "Adult (18+)"

eventType

string

required

The type of event being sold. Used to determine performance and conversion across product verticals.

startDate

date-time

ISO8601 date-time indicating when the product starts. Should reflect the local timezone of the event.
Optional for offers with fixed start dates.

endDate

date-time

ISO8601 date-time indicating when the product ends. Should reflect the local timezone of the event.
Optional for offers with fixed end dates.

partnerRiskEnd

date-time

The ISO8601 compliant date-time indicating the date and time when the partner/host’s cancellation policy becomes null and Spot/CFAR is the only active refund policy for the customer.

isPartialPayment

boolean

Indicates whether this quote is for a deposit-based booking.

hostCountry

string

The host country where the product/event is taking place.
May be required for trip and pass coverages.

hostCountryState

string

The host country state where the product/event is taking place.
May be required for trip and pass coverages.

destinations

array of strings

The destination countries for the trip.
May be required for trip and pass coverages.

destinations

dob

date-time

The date of birth of the person.

roundTo

number

Optional rounding target for bundled prices (e.g., 0.00, 0.49, 0.99).
If provided, overrides the rounding setting configured on the offer.
We always round up - to round to the next whole dollar, use 0.00.

eventId

string

A unique identifier for the event this coverage is associated with - useful if you may want to perform bulk operations on this event's coverages (such as updating dates in the event of a rescheduling).

Headers

X-Spot-Partner-Id

string

Spot Provided ID for Partner

Responses

400

The request for a quote is malformed.

401

You do not have access to request quotes.

429

A rate limit is in effect. Inspect the Retry-After header.

202A quote has been retrieved.