Skip to main content
GET
/
api
/
public
/
v2
/
seatmap
/
products
/
{productId}
/
variants
/
{variantId}
/
inventories
List inventory - Seatmap
curl --request GET \
  --url https://www.headout.com/api/public/v2/seatmap/products/{productId}/variants/{variantId}/inventories/ \
  --header 'Headout-Auth: <api-key>'
{
  "productId": 3023,
  "variantId": 4700,
  "inventoryId": 489560432,
  "currencyCode": "GBP",
  "date": "2026-03-25",
  "startTime": "19:30",
  "remaining": 342,
  "sections": [
    {
      "sectionName": "Front Stalls",
      "remaining": 89,
      "seats": [
        {
          "seatCode": "SE-A7112388-AF90-451B-86CB-51E61E121FDB-G-49",
          "row": "G",
          "seatNumber": "49",
          "seatType": "STANDARD",
          "pricing": {
            "currency": "GBP",
            "profileType": "PER_PERSON",
            "headoutSellingPrice": 129.0,
            "netPrice": 112.23
          }
        }
      ]
    },
    {
      "sectionName": "Royal Circle",
      "remaining": 52,
      "seats": [
        {
          "seatCode": "SE-D0445611-EG23-784E-B9FE-84H94G454HGE-A-12",
          "row": "A",
          "seatNumber": "12",
          "seatType": "PREMIUM",
          "pricing": {
            "currency": "GBP",
            "profileType": "PER_PERSON",
            "headoutSellingPrice": 189.0,
            "netPrice": 164.43
          }
        }
      ]
    }
  ]
}
For products with inventorySelectionType: SEATMAP. Returns all available seats for a specific show (date + time slot), grouped by section. Use this to display seats and pricing to users before creating a booking. 
{
  "productId": 3023,
  "variantId": 4700,
  "inventoryId": 489560432,
  "currencyCode": "GBP",
  "date": "2026-03-25",
  "startTime": "19:30",
  "remaining": 342,
  "sections": [
    {
      "sectionName": "Front Stalls",
      "remaining": 89,
      "seats": [
        {
          "seatCode": "SE-A7112388-AF90-451B-86CB-51E61E121FDB-G-49",
          "row": "G",
          "seatNumber": "49",
          "seatType": "STANDARD",
          "pricing": {
            "currency": "GBP",
            "profileType": "PER_PERSON",
            "headoutSellingPrice": 129.0,
            "netPrice": 112.23
          }
        }
      ]
    },
    {
      "sectionName": "Royal Circle",
      "remaining": 52,
      "seats": [
        {
          "seatCode": "SE-D0445611-EG23-784E-B9FE-84H94G454HGE-A-12",
          "row": "A",
          "seatNumber": "12",
          "seatType": "PREMIUM",
          "pricing": {
            "currency": "GBP",
            "profileType": "PER_PERSON",
            "headoutSellingPrice": 189.0,
            "netPrice": 164.43
          }
        }
      ]
    }
  ]
}

Authorizations

​
Headout-Auth
string
header
required

Path Parameters

​
productId
integer
required

Product identifier

​
variantId
integer
required

Primary variant identifier (from Availabilities response)

Query Parameters

​
date
string<date>
required

Show date (YYYY-MM-DD)

​
startTime
string
required

Show start time (HH:mm)

​
currencyCode
string

ISO 4217 currency code. Defaults to USD. Prices are converted to the requested currency.

Response

All available seats grouped by section

​
productId
integer
​
variantId
integer
​
inventoryId
integer<int64>

Show-level inventory identifier. Pass to Validate and Booking.

​
currencyCode
string
​
date
string<date>
​
startTime
string
​
remaining
integer
​
sections
object[]