Skip to main content
GET
/
api
/
public
/
v2
/
products
/
{productId}
cURL
curl --location 'https://www.headout.com/api/public/v2/products/<PRODUCT_ID>?campaignName=<CAMPAIGN_NAME>&languageCode=<LANGUAGE_CODE>&currencyCode=<CURRENCY_CODE>' \
--header 'Headout-Auth: <YOUR_API_KEY>'
{ "id": "19513", "name": "Edge Observation Deck Tickets", "canonicalUrl": "https://www.headout.com/edge-observation-deck-tickets/tickets-to-edge-observation-deck-e-19513/", "city": { "code": "NEW_YORK", "name": "New York", "image": { "url": "//cdn-imgix.headout.com/media/images/ee075882083344be170ed38c8c76b4a1-new-york-city-01.jpeg" } }, "media": [ { "url": "https://cdn-imgix.headout.com/media/images/7dff2143faf0c49109d1aeca8a7dcd9f-19513-new-york-edge-observation-deck-adimssion-tickets--09.jpg", "type": "IMAGE" } ], "startLocation": { "latitude": 40.753395080566406, "longitude": -74.00105285644531 }, "productType": "ATTRACTION", "reviewsSummary": { "ratingsCount": 5743, "averageRating": 4.4 }, "pricing": { "currency": "USD", "profileType": "PER_PERSON", "headoutSellingPrice": 39.2, "netPrice": 32.14 }, "listingPrice": { "type": "PER_PERSON", "currencyCode": "USD", "minimumPrice": { "originalPrice": 39.2, "finalPrice": 39.2 }, "bestDiscount": 0 }, "currency": { "code": "USD", "currencyName": "United States Dollar", "symbol": "US$", "localSymbol": "$", "precision": 2 }, "hasInstantConfirmation": true, "hasMobileTicket": true, "primaryCategory": { "id": "1", "name": "Tickets" }, "primarySubCategory": { "id": "1007", "name": "Landmarks", "categoryId": "1" }, "primaryCollection": { "id": "4012", "name": "Edge NYC", "cityCode": "NEW_YORK" }, "variants": [ { "id": "38164", "name": "General Admission: Timed Entry", "description": "Entry to Edge Observatory Deck at the time slot selected", "duration": 60000, "inventoryType": "FIXED_START_FLEXIBLE_DURATION", "pax": { "min": 1, "max": 10 }, "cashback": { "value": 0, "type": "ABSOLUTE" }, "ticketDeliveryInfoHtml": null, "inputFields": [ { "id": "NAME", "name": "Full Name", "dataType": "STRING", "level": "PRIMARY_CUSTOMER" } ], "tags": [ "RECOMMENDED" ], "pricing": { "currency": "USD", "profileType": "PER_PERSON", "headoutSellingPrice": 39.2, "netPrice": 32.14 } } ], "inventorySelectionType": "NORMAL", "cancellationPolicy": { "cancellable": false, "cancellableUpToInMinutes": null }, "reschedulePolicy": { "reschedulable": false, "reschedulableUpToInMinutes": null } }

Authorizations

​
Headout-Auth
string
header
required

Path Parameters

​
productId
string
required

ID of the product to fetch.

Query Parameters

​
languageCode
enum<string>
default:EN

Language code for localizing response content including product names, descriptions, and URLs. Defaults to English (EN). Content falls back to English when a translation is unavailable. See supported language codes.

Available options:
EN,
ES,
FR,
IT,
DE,
PT,
NL,
PL,
KO,
JA,
ZH_HANS,
ZH_HANT,
AR,
DA,
NO,
RO,
RU,
SV,
TR
​
currencyCode
string

Currency code for displaying prices (e.g., USD, EUR, GBP). All price fields in the response will use this currency. See Currency Codes.

​
campaignName
string

Partner-specific campaign identifier for tracking conversions and attributing bookings to marketing campaigns.

Response

200 - application/json

Successful response

Full product details including all variants, pricing, content, and media. Variants in this response include a pricing field.

​
id
string
required

Headout's unique product identifier. Use this to fetch full product details via the getProductById endpoint.

​
name
string
required

Display name of the experience (e.g., "Skip-the-Line Tickets to the Eiffel Tower").

​
canonicalUrl
string
required

The canonical Headout URL for this product page. Use for linking and affiliate tracking.

​
content
object
required

Editorial content for the product including highlights, summary, inclusions, and exclusions.

​
city
object
required

The city where this experience takes place.

​
media
object[]
required

Product images and videos for display in listings and product detail pages.

​
startLocation
object
required

Coordinates and address details of the meeting/departure point for this experience.

​
endLocation
object
required

Coordinates and address details of the drop-off/end point for this experience.

​
productType
enum<string>
required

Experience category. Useful for filtering and display logic.

Available options:
TOUR,
ACTIVITY,
EVENT,
ATTRACTION,
TRANSFER,
AIRPORT_TRANSFER,
ADD_ON
​
reviewsSummary
object
required

Aggregated rating and review count from verified Headout customers.

​
currency
object
required

Currency in which all prices in this response are denominated.

​
hasInstantConfirmation
boolean
required

Whether bookings for this product are confirmed immediately without manual review.

​
hasMobileTicket
boolean
required

Whether this product supports mobile/digital tickets (no print required).

​
inventorySelectionType
enum<string>
required

Inventory selection flow for this product. Determines how date/time selection should be presented to users.

Available options:
NORMAL,
SEATMAP
​
pricing
object

Pricing information for the product. The fields returned vary by partner type (Booking Partner vs Affiliate). At the product level, values represent the minimum across all variants.

​
listingPrice
object

Starting price for display on product cards. Reflects the cheapest available variant.

​
localeSpecificUrls
object

Localized product page URLs keyed by language code (EN, ES, FR, etc.), for use in multilingual storefronts.

​
primaryCategory
object

The main experience category this product belongs to (e.g., Tickets, Tours).

​
primarySubCategory
object

The subcategory within the primary category (e.g., Museums, Landmarks under Tickets).

​
primaryCollection
object

The primary themed collection grouping this product (e.g., Empire State Building, Broadway Shows).

​
variants
object[]
​
cancellationPolicy
object

Strictest cancellation policy applicable across all variants of this product.

​
reschedulePolicy
object

Strictest reschedule policy applicable across all variants of this product.