List availabilities - Normal - Headout API docs

curl --location 'https://www.headout.com/api/public/v2/products/2920/variants/4782/availabilities/?currencyCode=USD&startDate=2026-07-01&endDate=2026-07-31' \
--header 'Headout-Auth: <YOUR_API_KEY>'

{
  "productId": 2920,
  "variantId": 4782,
  "currencyCode": "USD",
  "availabilities": [
    {
      "date": "2026-07-14",
      "pricing": {
        "currency": "USD",
        "profileType": "PER_PERSON",
        "headoutSellingPrice": 220.33,
        "commissionAmount": 44.06
      },
      "availability": "LIMITED",
      "remaining": 5
    }
  ]
}

GET

api

public

products

{productId}

variants

{variantId}

availabilities

curl --location 'https://www.headout.com/api/public/v2/products/2920/variants/4782/availabilities/?currencyCode=USD&startDate=2026-07-01&endDate=2026-07-31' \
--header 'Headout-Auth: <YOUR_API_KEY>'

{
  "productId": 2920,
  "variantId": 4782,
  "currencyCode": "USD",
  "availabilities": [
    {
      "date": "2026-07-14",
      "pricing": {
        "currency": "USD",
        "profileType": "PER_PERSON",
        "headoutSellingPrice": 220.33,
        "commissionAmount": 44.06
      },
      "availability": "LIMITED",
      "remaining": 5
    }
  ]
}

Retrieve date-level availability for a specific variant of a normal product (inventorySelectionType: NORMAL) within a date range. Use this to power a calendar view; Affiliates deep-link to Headout’s own checkout for slot selection, so no separate slot-level inventory call is needed. For seatmap products, use List availabilities - Seatmap instead.

curl --location 'https://www.headout.com/api/public/v2/products/2920/variants/4782/availabilities/?currencyCode=USD&startDate=2026-07-01&endDate=2026-07-31' \
--header 'Headout-Auth: <YOUR_API_KEY>'

{
  "productId": 2920,
  "variantId": 4782,
  "currencyCode": "USD",
  "availabilities": [
    {
      "date": "2026-07-14",
      "pricing": {
        "currency": "USD",
        "profileType": "PER_PERSON",
        "headoutSellingPrice": 220.33,
        "commissionAmount": 44.06
      },
      "availability": "LIMITED",
      "remaining": 5
    }
  ]
}

Authorizations

Headout-Auth

string

header

required

Path Parameters

productId

integer

required

Normal product ID.

variantId

integer

required

Variant ID belonging to the product.

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

Product ID from the path parameter.

variantId

integer

Variant ID from the path parameter.

currencyCode

string

Resolved currency code used in this response.

availabilities

object[]

Date-level availability sorted ascending by date. Empty when no availability exists for the requested window.

Show child attributes

Get product by ID

List availabilities - Seatmap

⌘I

Guide

Cities

Collections

Categories

Subcategories

Products

Availabilities

Bookings

List availabilities - Normal

Authorizations

Path Parameters

Query Parameters

Response