> ## Documentation Index
> Fetch the complete documentation index at: https://partner.headout.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# What's new
> Latest updates, improvements, and changes to the Headout API
Stay up to date with the latest changes to the Headout API. Each release is documented here with the date and a summary of what changed.
## June 2026
### New endpoint: Get inventory details by ID
Partners can now fetch the exact customer input fields required for a specific inventory before creating a booking — enabling accurate booking form rendering without guessing from product-level fields.
* `GET` [Get inventory details by ID](/docs/api-partner/v2/inventory/details) — returns an `inputFields` array for the given `inventoryId`.
**Key details:**
* Path: `/api/public/v2/inventories/{inventoryId}/` — takes the inventory ID from the inventory listing response.
* Each field carries a numeric string `id` (e.g., `"224713"`) — use this directly as the field key when submitting `inputFields` in the [Create booking](/docs/api-partner/v2/bookings/create) request. Legacy string keys (`"NAME"`, `"CUSTOM_58384"`) continue to work for existing integrations.
* `validation.values` uses a typed `{type, value}` shape: `"TEXT"` for `ENUM` dropdowns (array of strings), `"PREDEFINED_LOCATION"` for location fields with predefined options (array of location objects). Omitted for all other field types.
* Each field includes a nullable `description` — helper text to display to the customer. Populated for supplier-defined `Custom` fields; `null` for standard fields (e.g., `Name`, `Email`, `Phone`) and for `Custom` fields with no description configured.
* Optional `languageCode` query parameter for localized field names, option labels, and descriptions. Defaults to `EN`.
## May 2026
### New sandbox base URL
The sandbox environment has moved to a new host. All sandbox API calls should now use **`https://www.sandbox-headout.com`** (previously `https://sandbox.api.dev-headout.com`).
* Update your sandbox base URL — see [Setup](/docs/guide/setup) for the current value and an example request.
* No changes to request/response schemas or authentication; only the host has changed.
* The previous host `https://sandbox.api.dev-headout.com` will continue to work, so existing integrations are unaffected. We recommend migrating to the new host at your convenience.
* Production endpoints are unaffected.
### Normal product availabilities
Added `GET` List availabilities - Normal for retrieving date-level availability for normal (non-seatmap) products.
Available for both API Partners and Affiliates:
* `GET` [List availabilities - Normal](/docs/api-partner/v2/availabilities/normal-availabilities) — API Partners
* `GET` [List availabilities - Normal](/docs/affiliate/v2/availabilities/normal-availabilities) — Affiliates
Notes:
* Only applies to products with `inventorySelectionType: NORMAL`.
* Returns one entry per date, with pricing from the lowest-priced slot.
* Supports optional `currencyCode`, `startDate`, and `endDate` query parameters.
* `startDate` defaults to today in the tour city timezone.
* `endDate` defaults to `startDate + 60 days`.
* The full date range cannot exceed 90 days inclusive.
### Cities response now includes country and timezone
The cities listing now returns each city's country (ISO code + name) and IANA timezone. Existing fields are unchanged — the new fields are purely additive.
Schema changes:
* `GET` [List all cities](/docs/api-partner/v2/cities/list) / [List all cities](/docs/affiliate/v2/cities/list) — each city in the response now includes `country: { code, name }` and `timezone` (e.g., `Europe/London`).
### Deprecation: `listingPrice` on V2 product responses
The `listingPrice` object on `List Products` and `Get Product` (both [API Partner](/docs/api-partner/v2/products/list) and [Affiliate](/docs/affiliate/v2/products/list)) is now deprecated. It will continue to be returned for backward compatibility and is **not** being removed, but new integrations should not rely on it.
Use the `pricing` object instead:
* Product-level `pricing` — starting "from" price across all variants and time slots
* Variant-level `pricing` (from `Get Product`) — starting price for a specific variant
* `inventory.pricing` — live, bookable slot price for checkout totals and booking validation
Note: the starting "from" price varies by date/time-slot even for single-variant products, since slot-level and supplier-backed inventory pricing changes. Treat it as the lowest currently-known starting point, not a fixed quote.
### Seatmap suite
Full seatmap product support is now available for API Partners and Agents. Partners can now discover, browse, and book seat-level theatre and live entertainment products end to end.
New endpoints:
* `GET` [Availabilities - Seatmap](/docs/api-partner/v2/seatmap/availabilities-by-variant) — available show dates, time slots, and pricing per variant
* `GET` [List Inventory - Seatmap](/docs/api-partner/v2/seatmap/inventory) — all available seats for a show, grouped by section
* `POST` [Validate - Seatmap](/docs/api-partner/v2/seatmap/validate) — live availability and pricing check on selected seats before checkout
* `GET` [Venue Map](/docs/api-partner/v2/seatmap/svg) — CDN URL for the venue layout SVG
* `GET` [Venue Iframe](/docs/api-partner/v2/seatmap/iframe) — Headout-hosted seat selection UI for iframe-based integrations
## April 2026
### Seatmap availability
Added `GET` List availabilities - Seatmap for retrieving seatmap availability for a specific variant within a date range.
Available for both API Partners and Affiliates:
* `GET` [List availabilities - Seatmap](/docs/api-partner/v2/seatmap/availabilities-by-variant) — API Partners
* `GET` [List availabilities - Seatmap](/docs/affiliate/v2/availabilities/seatmap-availabilities) — Affiliates
Notes:
* Supports optional `currencyCode`, `startDate`, and `endDate` query parameters.
* `startDate` defaults to today in the tour city timezone.
* `endDate` defaults to `startDate + 60 days`.
* The full date range cannot exceed 90 days inclusive.
## March 2026
### Booking flow
Added support for the full booking lifecycle:
* `POST` [Create a booking](/docs/api-partner/v2/bookings/create)
* `GET` [List all bookings](/docs/api-partner/v2/bookings/list)
* `GET` [Get a booking by ID](/docs/api-partner/v2/bookings/get)
* `PUT` [Capture a booking](/docs/api-partner/v2/bookings/update)
* `POST` [Cancel a booking](/docs/api-partner/v2/bookings/cancel)
* `POST` [Reschedule a booking](/docs/api-partner/v2/bookings/reschedule)
The cancel and reschedule endpoints have moved from `/api/public/v2/partner/booking/{bookingId}/...` to `/api/public/v2/bookings/{bookingId}/...`.
Existing integrations using the older endpoints will continue to work without changes.
### Cities and discovery
* `GET` [List Cities](/docs/api-partner/v2/cities/list) — returns a paginated, alphabetically sorted list of all discoverable cities.
### Response updates
* [List Cities](/docs/api-partner/v2/cities/list): new `limit` parameter (default `20`, max `20`).
* [List Bookings](/docs/api-partner/v2/bookings/list): default results per page changed to `20`, with `limit` capped at `20`.
* All booking endpoints now return structured error responses (`400`, `403`).
### Product pricing
A new `pricing` field has been added to the Product v2 APIs, giving partners direct access to pricing information without needing to fetch inventory.
**Available on:**
* [List Products](/docs/api-partner/v2/products/list) — `pricing` at the product level (minimum across all variants)
* [Get Product](/docs/api-partner/v2/products/get) — `pricing` at both the product and variant level
**Fields returned vary by partner type:**
| Field | API Partners | Affiliates |
| --------------------- | ------------ | ---------- |
| `currency` | Yes | Yes |
| `profileType` | Yes | Yes |
| `headoutSellingPrice` | Yes | Yes |
| `netPrice` | Yes | — |
| `commissionAmount` | — | Yes |