May 2026
May 29, 2026
New sandbox base URL
The sandbox environment has moved to a new host. All sandbox API calls should now usehttps://www.sandbox-headout.com (previously https://sandbox.api.dev-headout.com).- Update your sandbox base URL — see 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.comwill continue to work, so existing integrations are unaffected. We recommend migrating to the new host at your convenience. - Production endpoints are unaffected.
May 26, 2026
Normal product availabilities
AddedGET List availabilities - Normal for retrieving date-level availability for normal (non-seatmap) products.Available for both API Partners and Affiliates:GETList availabilities - Normal — API PartnersGETList availabilities - Normal — Affiliates
- Only applies to products with
inventorySelectionType: NORMAL. - Returns one entry per date, with pricing from the lowest-priced slot.
- Supports optional
currencyCode,startDate, andendDatequery parameters. startDatedefaults to today in the tour city timezone.endDatedefaults tostartDate + 60 days.- The full date range cannot exceed 90 days inclusive.
May 26, 2026
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:GETList all cities / List all cities — each city in the response now includescountry: { code, name }andtimezone(e.g.,Europe/London).
May 24, 2026
Deprecation: listingPrice on V2 product responses
The listingPrice object on List Products and Get Product (both API Partner and Affiliate) 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(fromGet Product) — starting price for a specific variant inventory.pricing— live, bookable slot price for checkout totals and booking validation
May 8, 2026
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:GETAvailabilities - Seatmap — available show dates, time slots, and pricing per variantGETList Inventory - Seatmap — all available seats for a show, grouped by sectionPOSTValidate - Seatmap — live availability and pricing check on selected seats before checkoutGETVenue Map — CDN URL for the venue layout SVGGETVenue Iframe — Headout-hosted seat selection UI for iframe-based integrations
April 2026
April 23, 2026
Seatmap availability
AddedGET List availabilities - Seatmap for retrieving seatmap availability for a specific variant within a date range.Available for both API Partners and Affiliates:GETList availabilities - Seatmap — API PartnersGETList availabilities - Seatmap — Affiliates
- Supports optional
currencyCode,startDate, andendDatequery parameters. startDatedefaults to today in the tour city timezone.endDatedefaults tostartDate + 60 days.- The full date range cannot exceed 90 days inclusive.
March 2026
March 23, 2026
Booking flow
Added support for the full booking lifecycle:POSTCreate a bookingGETList all bookingsGETGet a booking by IDPUTCapture a bookingPOSTCancel a bookingPOSTReschedule a booking
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
GETList Cities — returns a paginated, alphabetically sorted list of all discoverable cities.
Response updates
- List Cities: new
limitparameter (default20, max20). - List Bookings: default results per page changed to
20, withlimitcapped at20. - All booking endpoints now return structured error responses (
400,403).
March 19, 2026
Product pricing
A newpricing 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 —
pricingat the product level (minimum across all variants) - Get Product —
pricingat both the product and variant level
| Field | API Partners | Affiliates |
|---|---|---|
currency | Yes | Yes |
profileType | Yes | Yes |
headoutSellingPrice | Yes | Yes |
netPrice | Yes | — |
commissionAmount | — | Yes |