Retrieve Batch Quotes

post

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

Request quotes for Spot coverage to render at checkout. This endpoint is specific to carts that can have multiple items within them, and allows customers to cancel individual items in their cart, rather than needing to cancel all or none.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

currencyCode

string

enum

required

The currency used to purchase the products.

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.

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

isPartialPayment

boolean

Indicates whether these quotes are for a deposit-based bookings.

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 for all items.
Individual items can override this with their own roundTo value.
We always round up - to round to the next whole dollar, use 0.00.

items

array of objects

required

Array of items to quote.

items*

Headers

X-Spot-Partner-Id

string

Spot Provided ID for Partner

Responses

400

The request for batch quotes is malformed.

401

You do not have access to request quotes.

429

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

202Batch quotes have been processed.