Skip to main content
POST
Validate - Seatmap
For products with inventorySelectionType: SEATMAP. Performs a live availability and pricing check on a set of seats before checkout. Always check the validationErrors array even on 200 responses. A 200 response does not mean all seats are available — business-level failures (seat sold, seat not recognised) are returned as 200 with non-empty validationErrors. HTTP 4xx errors are returned for system-level failures (bad input, auth, product not found). Validate is recommended but not required before booking. Prices can change between the Inventory response and booking time — use the prices returned by this endpoint in the booking request. Seat count must satisfy the product’s minPax/maxPax constraint. Hard ceiling is 20 seats per request.

Validation error codes

Adjacency rules

Some venues enforce rules about which seats can be selected together. These are returned with code: ADJACENCY_RULE_VIOLATION. The seat itself is available — it is the combination of selected seats that violates the venue’s rule. Prompt the customer to adjust their selection.

Authorizations

Headout-Auth
string
header
required

Path Parameters

productId
integer
required
variantId
integer
required

Query Parameters

currencyCode
string

ISO 4217 currency code. Defaults to USD.

Body

application/json
inventoryId
integer<int64>
required

Show-level inventory identifier. Must be an integer — strings and floats are rejected with 400.

seatCodes
string[]
required
Maximum array length: 20

Response

Validation result. Check validationErrors array even on 200 responses.

productId
integer
variantId
integer
inventoryId
integer<int64>
currencyCode
string
date
string<date>
startTime
string
seats
object[]
validationErrors
object[]

Non-empty when one or more seats failed validation. Check this even on 200 responses.