Skip to main content
GET
/
api
/
public
/
v2
/
seatmap
/
products
/
{productId}
/
variants
/
{variantId}
/
availabilities
curl --location 'https://www.headout.com/api/public/v2/seatmap/products/3023/variants/4700/availabilities/?currencyCode=GBP&startDate=2026-04-15&endDate=2026-06-14' \
--header 'Headout-Auth: <YOUR_API_KEY>'

{
  "productId": 3023,
  "variantId": 4700,
  "currencyCode": "GBP",
  "availabilities": [
    {
      "date": "2026-04-15",
      "slots": [
        {
          "startTime": "14:30",
          "pricing": {
            "currency": "GBP",
            "profileType": "PER_PERSON",
            "headoutSellingPrice": 87.5,
            "commissionAmount": 17.5
          },
          "remaining": 163
        }
      ]
    }
  ]
}
Retrieve seatmap availability for a variant within a date range. 
curl --location 'https://www.headout.com/api/public/v2/seatmap/products/3023/variants/4700/availabilities/?currencyCode=GBP&startDate=2026-04-15&endDate=2026-06-14' \
--header 'Headout-Auth: <YOUR_API_KEY>'

{
  "productId": 3023,
  "variantId": 4700,
  "currencyCode": "GBP",
  "availabilities": [
    {
      "date": "2026-04-15",
      "slots": [
        {
          "startTime": "14:30",
          "pricing": {
            "currency": "GBP",
            "profileType": "PER_PERSON",
            "headoutSellingPrice": 87.5,
            "commissionAmount": 17.5
          },
          "remaining": 163
        }
      ]
    }
  ]
}

Authorizations

​
Headout-Auth
string
header
required

Path Parameters

​
productId
integer
required

Seatmap product ID.

​
variantId
integer
required

Variant ID, which must match the product's primary tour ID.

Query Parameters

​
currencyCode
string

Currency code for displaying prices. Defaults to USD when omitted.

​
startDate
string<date>

Beginning of the availability window in yyyy-MM-dd format. Defaults to today in the tour city timezone.

​
endDate
string<date>

End of the availability window in yyyy-MM-dd format. Defaults to startDate + 60 days. The date range cannot exceed 90 days inclusive.

Response

Successful response

​
productId
integer

Seatmap product ID from the path parameter.

​
variantId
integer

Primary tour ID backing this seatmap product.

​
currencyCode
string

Resolved currency code used in this response.

​
availabilities
object[]

Seatmap availability grouped by date, sorted ascending. Empty when no availability is returned for the requested window.