Travel Curious Reseller API Reference (Beta) 1.3 Proprietary

The Travel Curious Reseller API provides a flexible, high-performance solution for Resellers and Online Travel Agencies (OTAs) to seamlessly integrate with our global travel experience marketplace.

This API enables partners to:

Discover Inventory: Access a comprehensive catalog of Suppliers and Products with rich, localized content.
Real-time Availability: Query live capacity and pricing schedules to ensure accurate booking data.
Lifecycle Management: Manage the full booking flow, including temporary holds, secure confirmations, and cancellations.

🆕 What's New in v1.3

This version unlocks conversion-boosting features not available in legacy versions, including:

Rich Content Capabilities: A structured Content object is now available on Suppliers, Products, Rates, and Traveler Types. It provides localized, customer-facing descriptive data — multilingual text in multiple formats, media assets, feature highlights, FAQs, ratings, and reviews - kept separate from the core transactional fields.
Booking Questions: Some products require the Reseller to collect specific information from the guest as part of checkout. v1.3 introduces a formal BookingQuestions capability: a structured set of typed questions with localized text, dependency rules, PII flags, and defined submission phases.
Enhanced Location Data: Location data has been significantly improved in v1.3. The Location object now supports named types (such as MEETING_POINT, START, END, REDEMPTION, and POINT_OF_INTEREST) and carries a references[] array that links each location to records on external mapping platforms.
Expanded Data Structures: Enhancements across core entities introduce standardized transactional fields, giving Resellers the power to share additional data received from the Suppliers without breaking baseline schemas.

Server

https://booking.redeam.io/v1.3

Production server

https://booking.sandbox.redeam.io/v1.3

Sandbox server

Authentication

apiKey APIKeyHeader

Fields

Key	In
X-API-Key	Header

apiKey APISecretHeader

Fields

Key	In
X-API-Secret	Header

Suppliers

GET

/suppliers

GET

/suppliers/{supplier_id}

Retrieve a list of Suppliers

The Suppliers endpoints return information about the Operators connected to your account.

A Supplier represents the Operator providing the travel experience - a tour company, museum, attraction, or event venue. The Supplier object carries the operator's identity, contacts, accepted traveler types, business hours, and location data.

💡 Note on Retrieving Content: To optimize list performance and payload sizes, rich marketing content is not returned in this endpoint. To retrieve localized content at the Supplier level, you must request the specific operator via the singular endpoint (GET /suppliers/{supplier_id}) using the content=true query parameter.

Auth

Headers

X-Request-ID

string

Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.

Query String

partner_id	string	Return suppliers with a matching `partnerId` value.
code	string	Return suppliers with a matching `code` value.

GET /suppliers

 
curl --get \ --url 'https://booking.redeam.io/v1.3/suppliers' \ --header 'X-Request-ID: a9a03f82-8080-4772-ada3-dc678b28dfd9' \ --header 'X-API-Key: {X-API-Key}' \ --header 'X-API-Secret: {X-API-Secret}' \ --data partner_id={partner_id} \ --data code={code}
Copy

Responses

200

Retrieve a list of Suppliers

object	object
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string
suppliers	array[object]
id	uuid	ID of the Supplier. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Common name for the supplier that may be displayed to the customer.
title	string	Customer-facing name of the Supplier, intended for display in UIs.
description	string	A detailed overview of the Supplier or operator, highlighting their offerings, background, and value proposition. This content is intended for display in full detail pages and should help users understand what makes the Supplier unique.
code	string	Code of the Supplier. Every Supplier must have a unique Code.
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema Extensions may be used to exchange required operational or commercial information.
businessType	array[string]	DEPRECATED. Key word or words that identify the type of business pattern: `^\w+$`
contacts	array[object]	Supplier contact information.
email	string	Contact email address for correspondence and notifications.
name	string	Full name of the contact person.
phone	string	Contact phone number pattern: `^\+\d[\d\s-]+$`
title	string	The professional role or relationship of the contact.
mainLocation	object	Defines a physical place associated with the experience, such as a meeting point, a stop on an itinerary, or a redemption desk.
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
otherLocations	array[object]	Other locations of the Supplier
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
hours	array[object]	Hours of the Supplier
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
travelerTypes	array[object]	Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information.
ageBand	string	The primary age-based category for the traveler. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`STUDENT`,`UNKNOWN`,`YOUTH`
extensions	object	Extended data of the travelerType. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
maxAge	int32	The maximum age (inclusive) allowed for this traveler type.
minAge	int32	The minimum age (inclusive) required for this traveler type.
modifier	string	Additional qualification required for this price. Defaults to 'NONE' unless specific residency or status (e.g., MILITARY) is required. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
name	string	Name of the traveler type, e.g. Diver, Observer, Adult, Military
title	string	Customer-facing title for specific unit/traveler.
description	string	Structured description of the age, membership or role of the traveler this price is intended for.
constraints	array[object]
type	string	The category of the restriction. Enum: `MIN_AGE`,`MAX_AGE`,`MIN_WEIGHT`,`MAX_WEIGHT`,`MIN_HEIGHT`,`MAX_HEIGHT`,`REQUIRED_DOCUMENTS`,`OTHER`
min	number	The minimum value of this constraint.
max	number	The maximum value of this constraint.

401

Unauthorized

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

xxxxxxxxxx
 
{
 "meta": {...},
 "suppliers": [...]
}
Copy

Retrieve a single Supplier

Retrieve information for a specific Operator connected to your account using the unique supplier_id.

🚀 NEW — Content Capability: Content is not returned by default. To include it, add content=true to any singular GET endpoint.

Use the locale query parameter to pass a comma-separated list of BCP 47 language tags (e.g., locale=en-US,es-ES). When specified, the API will only return content fields matching those exact language tags.

Use the optional format query parameter to specify your required text format (plain, html, markdown). You can request multiple formats simultaneously by comma-separating them (e.g., format=html,markdown). If this parameter is not specified, all available formats are returned by default.

Auth

Headers

X-Request-ID

string

Path Params

supplier_id

string

The unique id of the supplier associated with this object.

Query String

content

boolean

If set to true, the response will include a 'content' field with detailed metadata.

Default: false

locale

string

Comma-separated list of BCP 47 language tags. If specified, only content matching one of these language tags will be returned.

format

string

Comma-separated list of formats. If specified, only content matching one of these formats will be returned.

Enum: plain,html,markdown

GET /suppliers/{supplier_id}

 
curl --get \ --url 'https://booking.redeam.io/v1.3/suppliers/45bcf276-8dc1-4b19-9752-05ffdc24068f' \ --header 'X-Request-ID: a9a03f82-8080-4772-ada3-dc678b28dfd9' \ --header 'X-API-Key: {X-API-Key}' \ --header 'X-API-Secret: {X-API-Secret}' \ --data content={content} \ --data locale={locale} \ --data format={format}
Copy

Responses

200

Retrieve a single Supplier

object	object
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string
supplier	object
id	uuid	ID of the Supplier. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Common name for the supplier that may be displayed to the customer.
title	string	Customer-facing name of the Supplier, intended for display in UIs.
description	string	A detailed overview of the Supplier or operator, highlighting their offerings, background, and value proposition. This content is intended for display in full detail pages and should help users understand what makes the Supplier unique.
code	string	Code of the Supplier. Every Supplier must have a unique Code.
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema Extensions may be used to exchange required operational or commercial information.
businessType	array[string]	DEPRECATED. Key word or words that identify the type of business pattern: `^\w+$`
contacts	array[object]	Supplier contact information.
email	string	Contact email address for correspondence and notifications.
name	string	Full name of the contact person.
phone	string	Contact phone number pattern: `^\+\d[\d\s-]+$`
title	string	The professional role or relationship of the contact.
mainLocation	object	Defines a physical place associated with the experience, such as a meeting point, a stop on an itinerary, or a redemption desk.
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
otherLocations	array[object]	Other locations of the Supplier
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
hours	array[object]	Hours of the Supplier
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
travelerTypes	array[object]	Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information.
ageBand	string	The primary age-based category for the traveler. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`STUDENT`,`UNKNOWN`,`YOUTH`
extensions	object	Extended data of the travelerType. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
maxAge	int32	The maximum age (inclusive) allowed for this traveler type.
minAge	int32	The minimum age (inclusive) required for this traveler type.
modifier	string	Additional qualification required for this price. Defaults to 'NONE' unless specific residency or status (e.g., MILITARY) is required. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
name	string	Name of the traveler type, e.g. Diver, Observer, Adult, Military
title	string	Customer-facing title for specific unit/traveler.
description	string	Structured description of the age, membership or role of the traveler this price is intended for.
constraints	array[object]
type	string	The category of the restriction. Enum: `MIN_AGE`,`MAX_AGE`,`MIN_WEIGHT`,`MAX_WEIGHT`,`MIN_HEIGHT`,`MAX_HEIGHT`,`REQUIRED_DOCUMENTS`,`OTHER`
min	number	The minimum value of this constraint.
max	number	The maximum value of this constraint.
content	object	Provides localized, structured, and customer-facing content that can be attached to multiple entities. This object is the primary source for descriptive marketing data across all levels of the catalog. This Content object can be attached to: Suppliers (Company bios, logos) Products (Full experience descriptions, media) Options / Rates (Route or language-specific details) Units / TravelerType (Specific details for Adult, Child, or special TravelerType/Units) The Content object supports multilingual text, rich media, features, FAQs, ratings, and reviews intended for display in Reseller and customer-facing experiences. When present, consumers SHOULD prioritize values from the Content object for display and fall back to the corresponding standard entity fields when content data is not available.
id	string	Unique identifier for this content object. Used to reference and manage content independently of the parent entity.
name	array[object]	A LocalizedTextSet describing the content's name.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
title	array[object]	A LocalizedTextSet describing the content's title.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
subtitle	array[object]	A LocalizedTextSet describing the content's subtitle.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
description	array[object]	A LocalizedTextSet describing the content's description.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
shortDescription	array[object]	A LocalizedTextSet describing the content's short description.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
categories	array[object]	A LocalizedTextSet describing the content's categories.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
duration	object	Indicates the typical or expected duration of the experience. May include a numeric length, unit, and optional localized description.
length	number	Numeric duration value expressed in the specified unit.
flexible	boolean	If `true`, the duration is an estimate (e.g., 'approx. 3 hours'). If `false`, the duration is fixed (e.g., a 45-minute flight).
unit	string	Unit of time used to interpret the duration length. Enum: `minutes`,`hours`,`days`,`weeks`
description	array[object]	A short description of this duration.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
faqs	array[object]
question	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
answer	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
features	array[object]
type	string	Classification of the feature. Enum: `INCLUSION`,`EXCLUSION`,`HIGHLIGHT`,`PREBOOKING_INFORMATION`,`PREARRIVAL_INFORMATION`,`REDEMPTION_INSTRUCTION`,`ACCESSIBILITY_INFORMATION`,`ADDITIONAL_INFORMATION`,`BOOKING_TERMS_AND_CONDITIONS`,`CANCELLATION_TERMS_AND_CONDITIONS`,`TERMS_AND_CONDITIONS`,`RESTRICTION_REQUIREMENT`,`SAFETY_INFORMATION`,`PRIVATE`,`COMMENTARY`,`OTHER`
description	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
media	array[object]
url	string	Direct link to the media asset (image, video, etc.). Must be publicly accessible.
type	string	The media file type. Enum: `image/jpeg`,`image/png`,`image/webp`,`image/svg+xml`,`video/mp4`,`video/avi`,`external/youtube`,`external/vimeo`,`external/other`,`application/pdf`
relationship	string	Describes how the media relates to the object. Examples: "logo" (Supplier branding), "cover" (hero image for Product), "gallery" (set of supplementary visuals). Helps clients render or prioritize media appropriately. Enum: `LOGO`,`COVER`,`GALLERY`,`OTHER`
title	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
caption	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
copyright	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
credits	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
metadata	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
ratings	array[object]
source	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
average	object	Aggregates review scores from sources like Google, TripAdvisor, Yelp, etc. This provides social proof, helping users quickly evaluate the quality and reliability of the experience.
value	number	Rating value.
min	integer	Minimum possible rating.
max	integer	Maximum possible rating.
count	integer	Total number of ratings that contributed to the average. Must be non-negative values (integer ≥ 0).
lastUpdated	date-time	Timestamp of the last time the rating data was refreshed. Format: ISO 8601 (e.g., "2025-06-25T10:00:00Z"). Always use a valid lastUpdated timestamp
reviews	array[object]
reviewerName	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
title	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
content	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
source	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
rating	object	Aggregates review scores from sources like Google, TripAdvisor, Yelp, etc. This provides social proof, helping users quickly evaluate the quality and reliability of the experience.
value	number	Rating value.
min	integer	Minimum possible rating.
max	integer	Maximum possible rating.
createdAt	date-time	Timestamp of when the review was created. Useful for sorting and freshness. Format: ISO 8601 (e.g., "2025-06-25T14:20:00Z").
verified	boolean	Indicates whether the review is from a verified booking or customer. Helps establish credibility and trust.
metadata	object	Additional system-level metadata related to this content, such as timestamps or internal bookkeeping fields.
lastUpdated	date-time	Timestamp indicating when the record was last updated.

401

Unauthorized

404

Not Found

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

 
{ "meta": {  "reqId": "5fd78809-4700-46d7-8386-3b8738117f4d" }, "supplier": {  "id": "08e4f505-3374-447e-b3b0-32698603b155",  "code": "skyline_city_tours_lon",  "version": 3,  "name": "Skyline City Tours London",  "title": "Skyline - Premium London Sightseeing",  "description": "Discover the secrets of London with our award-winning walking and bus tours.",  "businessType": [   "tour_operator"  ],  "contacts": [   {    "name": "London Support",    "email": "uk-support@skyline-tours.example.com",    "phone": "+44 20 7946 0000",    "title": "Branch Lead"   }  ],  "hours": [   {    "timezone": "Europe/London",    "daysOfWeek": [     1,     2,     3,     4,     5    ],    "times": [     {      "open": "09:00",      "close": "18:00"     }    ],    "valid": {     "from": "2026-01-01T00:00:00Z"    }   }  ],  "mainLocation": {   "name": "Westminster Meeting Point",   "type": "PRIMARY",   "address": {    "streetAddress": "Victoria Embankment",    "locality": "London",    "countryCode": "GBR"   },   "longLat": {    "latitude": 51.5074,    "longitude": -0.1278   }  },  "content": {   "id": "content_sct_lon_002",   "media": [    {     "url": "https://cdn.example.com/sct/london-bridge.jpg",     "type": "image/jpeg",     "relationship": "COVER"    }   ]  },  "extensions": {   "x-ticketingSystem": "NativeCloud"  },  "partnerId": "partner-ext-1122" }}
Copy

Products

GET

/suppliers/{supplier_id}/products

GET

/suppliers/{supplier_id}/products/{product_id}

Retrieve a list of Products

Returns a list of Products connected to your account. You can filter the list to retrieve all products belonging to a specific parent Supplier.

A Product is a bookable experience offered by a Supplier - a walking tour, museum entry, river cruise, or live show. Each Product belongs to one Supplier and may have multiple Rates.

💡 Note on Retrieving Content: To optimize list performance and payload sizes, rich marketing content is not returned in this endpoint. To retrieve localized content at the Product level, you must request the specific experience via the singular endpoint (GET /suppliers/{supplier_id}/products/{product_id}) using the content=true query parameter.

Auth

Headers

X-Request-ID

string

Path Params

supplier_id

string

The unique id of the supplier associated with this object.

Query String

limit	integer	Limit Product list
offset	integer	Offset Product list
partner_id	string	Partner defined ID
code	string	Product code

GET /suppliers/{supplier_id}/products

 
curl --get \ --url 'https://booking.redeam.io/v1.3/suppliers/45bcf276-8dc1-4b19-9752-05ffdc24068f/products' \ --header 'X-Request-ID: a9a03f82-8080-4772-ada3-dc678b28dfd9' \ --header 'X-API-Key: {X-API-Key}' \ --header 'X-API-Secret: {X-API-Secret}' \ --data limit={limit} \ --data offset={offset} \ --data partner_id={partner_id} \ --data code={code}
Copy

Responses

200

Retrieve a list of Products

object	object
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string
page	object	Returns the limit and offset used in the request.
limit	int32
offset	int32
products	array[object]
id	uuid	ID of the Product. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Name the Supplier uses to identify the Product
title	string	Customer-facing Product name, suitable for marketing or UI display.
description	string	Long-form Product narrative describing the activity, experience or event. This content is intended for display on Product detail pages and should help users understand what is being offered.
code	string	Code of the Product
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: securityPolicy: Large bags and strollers must be checked at the storage lockers.
supplierId	uuid	The unique identifier of the Supplier that owns and operates this Product. This ID matches the id field of the parent Supplier entity and is used to maintain the relational link between the Supplier's organization and their inventory.
deliveryFormats	string	Specifies the technical format of the barcode or identifier that will be issued upon booking confirmation. This field informs the Reseller how to correctly parse, render, or encode the ticket value for the end guest. While the list contains standard industry types like `QR_CODE` and `CODE128`, Resellers must ensure their systems can handle any format specified here to successfully distribute this Product. Enum: `QR_CODE`,`EAN13`,`CODE128`,`UPCA`,`TEXT`,`CODE39`,`URL`,`INTERLEAVED`
deliveryMethods	string	Defines how fulfillment identifiers are distributed within a booking. A value of `TICKET` means a unique barcode or identifier is issued for every individual guest or unit in the booking. A value of `VOUCHER` indicates that a single identifier is issued for the entire booking and is shared across all guests. Enum: `TICKET`,`VOUCHER`
instantConfirmation	boolean	Indicates whether the booking is confirmed immediately. If `false`, the request requires asynchronous processing (due to Supplier review or system load); Resellers should expect an initial `PENDING` state and must handle delayed confirmation to the customer.
instantDelivery	boolean	Indicates whether fulfillment identifiers (tickets/vouchers) are available immediately upon confirmation. If `false`, the delivery process is asynchronous (due to system latency or generation delays); Resellers must handle a secondary fulfillment step and should not promise the customer immediate access to their tickets.
redemptionInstructions	string	Provides clear, human-readable directions explaining how the guest should redeem their ticket or voucher at the venue.
redemptionMethod	string	This indicates the redemption requirements for the customer. A value of MANIFEST indicates that the customer MUST provide a form of identification to redeem and as such a printed or digital copy of the ticket is OPTIONAL. A value of DIGITAL indicates that the customer MUST provide a copy of the ticket but MAY be digital or printed. A value of PRINT indicates that the customer MUST provide a printed copy of the ticket (this is typically only used when the Supplier must retain the printed copy for their records). Enum: `MANIFEST`,`DIGITAL`,`PRINT`
locale	string	Language and region identifier. Must be a valid BCP 47 RFC 5646 RFC 4647 language tag.
productType	array[string]	Classifies the operational nature of the Product to determine the booking behavior. `ATTRACTION` is used for standard entries or tours. `SEATING` indicates that specific seat selection is required. `BEST_AVAILABLE` implies the system will automatically assign the most optimal seating at the time of booking. Enum: `ATTRACTION`,`SEATING`,`BEST_AVAILABLE`
contacts	array[object]	Product contact information.
email	string	Contact email address for correspondence and notifications.
name	string	Full name of the contact person.
phone	string	Contact phone number pattern: `^\+\d[\d\s-]+$`
title	string	The professional role or relationship of the contact.
hours	array[object]	Hours of the Product
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
location	object	Defines a physical place associated with the experience, such as a meeting point, a stop on an itinerary, or a redemption desk.
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
otherLocations	array[object]	Additional locations for the Product
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.

401

Unauthorized

404

Not Found

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

 
{ "meta": {  "reqId": "5fd78809-4700-46d7-8386-3b8738117f4d" }, "products": [  {   "id": "f42d88a1-8892-4c2a-b772-992a8e310022",   "supplierId": "08e4f505-3374-447e-b3b0-32698603b155",   "OrganizationID": "org-global-water-001",   "code": "OA-BCN-PARA-SUNSET",   "version": 1,   "name": "Sunset Parasailing Adventure",   "title": "Sky High: Barcelona Sunset Parasailing",   "description": "Soar 150 meters above the Mediterranean during the golden hour.",   "productType": [    "ATTRACTION"   ],   "deliveryFormats": [    "QR_CODE",    "URL"   ],   "deliveryMethods": [    "VOUCHER"   ],   "instantConfirmation": true,   "instantDelivery": true,   "locale": "en-US",   "redemptionInstructions": "Redeem your voucher at the Beachside Kiosk near the W Hotel.",   "contacts": [    {     "name": "Beach Operations",     "email": "beach@example.com",     "phone": "+34 931 00 00 10",     "title": "Beach Coordinator"    }   ],   "hours": [    {     "timezone": "Europe/Madrid",     "daysOfWeek": [      1,      2,      3,      4,      5,      6,      7     ],     "times": [      {       "open": "17:00",       "close": "21:00"      }     ],     "valid": {      "from": "2026-05-01T00:00:00Z",      "until": "2026-09-30T23:59:59Z"     }    }   ],   "location": {    "name": "Beachside Kiosk",    "title": "Oceanic Sunset Base",    "description": "Directly on the sand.",    "type": "MEETING_POINT",    "address": {     "streetAddress": "Platja de la Barceloneta",     "locality": "Barcelona",     "region": "Catalunya",     "postalCode": "08003",     "countryCode": "ESP"    },    "longLat": {     "latitude": 41.3688,     "longitude": 2.1901    }   },   "otherLocations": [    {     "name": "Deep Water Take-off Zone",     "title": "Parasail Boat Launch",     "type": "START",     "address": {      "locality": "Barcelona Offshore",      "countryCode": "ESP"     }    }   ],   "extensions": {    "x-max-height": "150m"   },   "partnerId": "partner-id-6677"  } ]}
Copy

Retrieve a single Product

Retrieve information for a specific Product belonging to a specific parent Supplier connected to your account using the unique supplier_id and product_id.

A Product is a bookable experience offered by a Supplier - a walking tour, museum entry, river cruise, or live show. Each Product belongs to one Supplier and may have multiple Rates.

🚀 NEW — Content Capability: To retrieve Content, you must request the specific Product via its singular endpoint (GET /suppliers/{supplier_id}/products/{product_id) using the content=true query parameter.

Auth

Headers

X-Request-ID

string

Path Params

product_id	string
supplier_id	string

Query String

content

boolean

If set to true, the response will include a 'content' field with detailed metadata.

Default: false

locale

string

Comma-separated list of BCP 47 language tags. If specified, only content matching one of these language tags will be returned.

format

string

Comma-separated list of formats. If specified, only content matching one of these formats will be returned.

Enum: plain,html,markdown

GET /suppliers/{supplier_id}/products/{product_id}

 
curl --get \ --url 'https://booking.redeam.io/v1.3/suppliers/08e4f505-3374-447e-b3b0-32698603b155/products/f42d88a1-8892-4c2a-b772-992a8e310022' \ --header 'X-Request-ID: a9a03f82-8080-4772-ada3-dc678b28dfd9' \ --header 'X-API-Key: {X-API-Key}' \ --header 'X-API-Secret: {X-API-Secret}' \ --data content={content} \ --data locale={locale} \ --data format={format}
Copy

Responses

200

Successfully retrieved a single Product.

object	object
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string
product	object
id	uuid	ID of the Product. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Name the Supplier uses to identify the Product
title	string	Customer-facing Product name, suitable for marketing or UI display.
description	string	Long-form Product narrative describing the activity, experience or event. This content is intended for display on Product detail pages and should help users understand what is being offered.
code	string	Code of the Product
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: securityPolicy: Large bags and strollers must be checked at the storage lockers.
supplierId	uuid	The unique identifier of the Supplier that owns and operates this Product. This ID matches the id field of the parent Supplier entity and is used to maintain the relational link between the Supplier's organization and their inventory.
deliveryFormats	string	Specifies the technical format of the barcode or identifier that will be issued upon booking confirmation. This field informs the Reseller how to correctly parse, render, or encode the ticket value for the end guest. While the list contains standard industry types like `QR_CODE` and `CODE128`, Resellers must ensure their systems can handle any format specified here to successfully distribute this Product. Enum: `QR_CODE`,`EAN13`,`CODE128`,`UPCA`,`TEXT`,`CODE39`,`URL`,`INTERLEAVED`
deliveryMethods	string	Defines how fulfillment identifiers are distributed within a booking. A value of `TICKET` means a unique barcode or identifier is issued for every individual guest or unit in the booking. A value of `VOUCHER` indicates that a single identifier is issued for the entire booking and is shared across all guests. Enum: `TICKET`,`VOUCHER`
instantConfirmation	boolean	Indicates whether the booking is confirmed immediately. If `false`, the request requires asynchronous processing (due to Supplier review or system load); Resellers should expect an initial `PENDING` state and must handle delayed confirmation to the customer.
instantDelivery	boolean	Indicates whether fulfillment identifiers (tickets/vouchers) are available immediately upon confirmation. If `false`, the delivery process is asynchronous (due to system latency or generation delays); Resellers must handle a secondary fulfillment step and should not promise the customer immediate access to their tickets.
redemptionInstructions	string	Provides clear, human-readable directions explaining how the guest should redeem their ticket or voucher at the venue.
redemptionMethod	string	This indicates the redemption requirements for the customer. A value of MANIFEST indicates that the customer MUST provide a form of identification to redeem and as such a printed or digital copy of the ticket is OPTIONAL. A value of DIGITAL indicates that the customer MUST provide a copy of the ticket but MAY be digital or printed. A value of PRINT indicates that the customer MUST provide a printed copy of the ticket (this is typically only used when the Supplier must retain the printed copy for their records). Enum: `MANIFEST`,`DIGITAL`,`PRINT`
locale	string	Language and region identifier. Must be a valid BCP 47 RFC 5646 RFC 4647 language tag.
productType	array[string]	Classifies the operational nature of the Product to determine the booking behavior. `ATTRACTION` is used for standard entries or tours. `SEATING` indicates that specific seat selection is required. `BEST_AVAILABLE` implies the system will automatically assign the most optimal seating at the time of booking. Enum: `ATTRACTION`,`SEATING`,`BEST_AVAILABLE`
contacts	array[object]	Product contact information.
email	string	Contact email address for correspondence and notifications.
name	string	Full name of the contact person.
phone	string	Contact phone number pattern: `^\+\d[\d\s-]+$`
title	string	The professional role or relationship of the contact.
hours	array[object]	Hours of the Product
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
location	object	Defines a physical place associated with the experience, such as a meeting point, a stop on an itinerary, or a redemption desk.
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
otherLocations	array[object]	Additional locations for the Product
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
content	object	Provides localized, structured, and customer-facing content that can be attached to multiple entities. This object is the primary source for descriptive marketing data across all levels of the catalog. This Content object can be attached to: Suppliers (Company bios, logos) Products (Full experience descriptions, media) Options / Rates (Route or language-specific details) Units / TravelerType (Specific details for Adult, Child, or special TravelerType/Units) The Content object supports multilingual text, rich media, features, FAQs, ratings, and reviews intended for display in Reseller and customer-facing experiences. When present, consumers SHOULD prioritize values from the Content object for display and fall back to the corresponding standard entity fields when content data is not available.
id	string	Unique identifier for this content object. Used to reference and manage content independently of the parent entity.
name	array[object]	A LocalizedTextSet describing the content's name.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
title	array[object]	A LocalizedTextSet describing the content's title.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
subtitle	array[object]	A LocalizedTextSet describing the content's subtitle.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
description	array[object]	A LocalizedTextSet describing the content's description.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
shortDescription	array[object]	A LocalizedTextSet describing the content's short description.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
categories	array[object]	A LocalizedTextSet describing the content's categories.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
duration	object	Indicates the typical or expected duration of the experience. May include a numeric length, unit, and optional localized description.
length	number	Numeric duration value expressed in the specified unit.
flexible	boolean	If `true`, the duration is an estimate (e.g., 'approx. 3 hours'). If `false`, the duration is fixed (e.g., a 45-minute flight).
unit	string	Unit of time used to interpret the duration length. Enum: `minutes`,`hours`,`days`,`weeks`
description	array[object]	A short description of this duration.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
faqs	array[object]
question	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
answer	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
features	array[object]
type	string	Classification of the feature. Enum: `INCLUSION`,`EXCLUSION`,`HIGHLIGHT`,`PREBOOKING_INFORMATION`,`PREARRIVAL_INFORMATION`,`REDEMPTION_INSTRUCTION`,`ACCESSIBILITY_INFORMATION`,`ADDITIONAL_INFORMATION`,`BOOKING_TERMS_AND_CONDITIONS`,`CANCELLATION_TERMS_AND_CONDITIONS`,`TERMS_AND_CONDITIONS`,`RESTRICTION_REQUIREMENT`,`SAFETY_INFORMATION`,`PRIVATE`,`COMMENTARY`,`OTHER`
description	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
media	array[object]
url	string	Direct link to the media asset (image, video, etc.). Must be publicly accessible.
type	string	The media file type. Enum: `image/jpeg`,`image/png`,`image/webp`,`image/svg+xml`,`video/mp4`,`video/avi`,`external/youtube`,`external/vimeo`,`external/other`,`application/pdf`
relationship	string	Describes how the media relates to the object. Examples: "logo" (Supplier branding), "cover" (hero image for Product), "gallery" (set of supplementary visuals). Helps clients render or prioritize media appropriately. Enum: `LOGO`,`COVER`,`GALLERY`,`OTHER`
title	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
caption	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
copyright	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
credits	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
metadata	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
ratings	array[object]
source	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
average	object	Aggregates review scores from sources like Google, TripAdvisor, Yelp, etc. This provides social proof, helping users quickly evaluate the quality and reliability of the experience.
value	number	Rating value.
min	integer	Minimum possible rating.
max	integer	Maximum possible rating.
count	integer	Total number of ratings that contributed to the average. Must be non-negative values (integer ≥ 0).
lastUpdated	date-time	Timestamp of the last time the rating data was refreshed. Format: ISO 8601 (e.g., "2025-06-25T10:00:00Z"). Always use a valid lastUpdated timestamp
reviews	array[object]
reviewerName	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
title	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
content	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
source	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
rating	object	Aggregates review scores from sources like Google, TripAdvisor, Yelp, etc. This provides social proof, helping users quickly evaluate the quality and reliability of the experience.
value	number	Rating value.
min	integer	Minimum possible rating.
max	integer	Maximum possible rating.
createdAt	date-time	Timestamp of when the review was created. Useful for sorting and freshness. Format: ISO 8601 (e.g., "2025-06-25T14:20:00Z").
verified	boolean	Indicates whether the review is from a verified booking or customer. Helps establish credibility and trust.
metadata	object	Additional system-level metadata related to this content, such as timestamps or internal bookkeeping fields.
lastUpdated	date-time	Timestamp indicating when the record was last updated.

401

Unauthorized

404

Not Found

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

xxxxxxxxxx
 
{
 "meta": {...},
 "product": {...}
}
Copy

Rates

GET

/suppliers/{supplier_id}/products/{product_id}/rates

GET

/suppliers/{supplier_id}/products/{product_id}/rates/{rate_id}

Retrieve a list of Rates

Returns a list of Rates connected to your account. You can filter the list to retrieve all rates belonging to a specific parent product_idand supplier_id.

A Rate defines a specific bookable option within a Product. A single Product can have multiple Rates, for example, separate morning and afternoon sessions with independent capacity, or a standard and premium tier. Each Rate has its own pricing, hours, cancellation policy, and hold configuration.

🚀 NEW — Booking Questions To retrieve Booking Questions, you must use the bookingQuestions=true query parameter.

Use the locale query parameter to pass a comma-separated list of BCP 47 language tags (e.g., locale=en-US,es-ES). When specified, the API will only return content fields matching those exact language tags.

💡 Note on Retrieving Content: To optimize list performance and payload sizes, rich marketing content is not returned in this endpoint. To retrieve localized content at the Rate level, you must request the specific option via the singular endpoint (GET /suppliers/{supplier_id}/products/{product_id}/rates/{rate_id}) using the content=true query parameter.

Auth

Headers

X-Request-ID

string

Path Params

product_id	string	The unique `id` of this rate's parent product.
supplier_id	string

Query String

valid_during_end	string	Filters valid Rates within end time
valid_during_start	string	Filters valid Rates within start time.
valid_from	string	End time to query.
valid_until	string	Start time to query.
limit	integer	Limit to query.
offset	integer	Offset to query.
option_id	string	Option ID to query, identifies Rates as being grouped together
partner_id	string	Partner defined ID
code	string	Rate code to query.
bookingQuestions	boolean	Includes booking questions field in the response, if available. Default: false

GET /suppliers/{supplier_id}/products/{product_id}/rates

 
curl --get \ --url 'https://booking.redeam.io/v1.3/suppliers/30c752e0-8057-4c7b-8ccb-9cd0c6996605/products/539aa96d-3f2b-41b7-8341-d847c0262c6b/rates' \ --header 'X-Request-ID: a9a03f82-8080-4772-ada3-dc678b28dfd9' \ --header 'X-API-Key: {X-API-Key}' \ --header 'X-API-Secret: {X-API-Secret}' \ --data valid_during_end={valid_during_end} \ --data valid_during_start={valid_during_start} \ --data valid_from={valid_from} \ --data valid_until={valid_until} \ --data limit={limit} \ --data offset={offset} \ --data option_id={option_id} \ --data partner_id={partner_id} \ --data code={code} \ --data bookingQuestions={bookingQuestions}
Copy

Responses

200

Retrieve a list of Rates

object	object
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string
rates	array[object]
id	uuid	ID of the Rate. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Name used to identify a specific Product Option/Rate or variation
title	string	Customer-facing title for specific Option/Rate.
description	string	A detailed explanation of the specific activity, experience, or event offered in this Option/Rate. This long-form content is meant to appear on Product detail pages, highlighting experience-specific details or restrictions.
code	string	Code of the Rate
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: cancelPolicyDescription: Full refund available up to 24 hours before start time.
productId	uuid	The unique identifier of the parent Product associated with this Rate. This ID matches the `id` field of the parent Product entity and is used to maintain the relational link between the specific Rate option and its high-level Product definition.
optionId	uuid	Operator's internal identifier for this rate. This field's value is not consumed by this API, and this information is provided for informational purposes only.
type	string	Defines the inventory and booking logic for the Rate. `FREESALE` indicates constant availability without fixed capacity limits. `PASS` is used for open-dated entry or multi-use Products. `RESERVED` indicates fixed capacity requiring specific date/time selection. Enum: `FREESALE`,`PASS`,`RESERVED`,`UNKNOWN`
cancelable	boolean	Defines the cancellation policy for this Rate. When `true`, it indicates that bookings made under this Rate are eligible for cancellation.
refundable	boolean	Indicates if a booking made with this Rate is eligible for a monetary refund. This defines the financial policy, whereas `cancelable` defines the operational ability to void a booking.
cutoff	int64	The Rate's "cutoff" property is subtracted from the event's start time (the availability start time) when determining the latest possible time a hold can be made against a particular start time.
holdable	boolean	Indicates whether this Rate supports the creation of a temporary booking hold. If `true`, inventory can be reserved for a limited time to finalize guest details prior to formal confirmation.
holdablePeriod	int64	The maximum duration (in seconds) that a hold remains valid. Resellers must confirm the booking within this window; otherwise, the hold will automatically expire and the inventory will be released.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
maxTravelers	int64	The maximum number of travelers (inclusive) allowed within a single Booking or Hold item. Requests exceeding this limit must be split into separate items or bookings.
minTravelers	int64	The minimum number of travelers (inclusive) required for a single Booking or Hold item. The request will be rejected if the guest count is below this threshold.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
hours	array[object]	The operational or opening hours for the experience. This defines the physical operating window of the venue and is distinct from real-time booking availability or capacity data.
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
prices	array[object]	A list of pricing configurations for this Rate. This defines the cost structure and any applicable Traveler Type distinctions.
id	uuid	Unique identifier for this Rate price
includedTaxes	array[object]	Breakdown of taxes included in the price dedicated to government taxes and fees.
currency	string	The currency code (ISO 4217 format) in which the tax amount is expressed (e.g., "USD", "EUR"). The currency must match the currency used for the item's price (original, net or retails). (required from Supplier) pattern: `^[A-Za-z]{3}$`
id	string	A unique identifier for the tax or fee. Strongly recommended for internal reference and integration purposes. (not required to be a UUID).
name	string	Human-readable title of the included taxes entry. A short, descriptive name for the tax being applied (e.g., "VAT", "City Tax"). The name should be unique. If no tax id is provided, the system will use the combination of name and currency to identify uniqueness. (required from Supplier)
original	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the original price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
net	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the net price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
retail	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the retail price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
labels	array[string]	A list of filterable tags assigned to this price. Used in ChannelBindings (priceTags) to filter prices available by channel.
name	string	Human-readable name for the pricing.
net	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
original	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
retail	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
status	string	Determines if bound channels can list this price. Only 'ACTIVE' prices should be sold. Enum: `ACTIVE`,`INACTIVE`
travelerType	object	Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information.
ageBand	string	The primary age-based category for the traveler. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`STUDENT`,`UNKNOWN`,`YOUTH`
extensions	object	Extended data of the travelerType. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
maxAge	int32	The maximum age (inclusive) allowed for this traveler type.
minAge	int32	The minimum age (inclusive) required for this traveler type.
modifier	string	Additional qualification required for this price. Defaults to 'NONE' unless specific residency or status (e.g., MILITARY) is required. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
name	string	Name of the traveler type, e.g. Diver, Observer, Adult, Military
title	string	Customer-facing title for specific unit/traveler.
description	string	Structured description of the age, membership or role of the traveler this price is intended for.
constraints	array[object]
type	string	The category of the restriction. Enum: `MIN_AGE`,`MAX_AGE`,`MIN_WEIGHT`,`MAX_WEIGHT`,`MIN_HEIGHT`,`MAX_HEIGHT`,`REQUIRED_DOCUMENTS`,`OTHER`
min	number	The minimum value of this constraint.
max	number	The maximum value of this constraint.
unitId	string	Unique identifier for RatePrice which is Supplier specific e.g. Supplier's SKU code
extensions	object	Extended data for the rate price. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information.
locations	array[object]
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
bookingQuestions	array[object]	An array of questions that can be asked during the booking flow. Visible when the `bookableQuestions` query parameter is set to `true`.
id	string
type	string	Describes the format of the answer expected by this question. - `text`, `email` and `phone` are all basic text types. - `integer` and `decimal` are numeric. - `boolean` is true/false. - `choice`, `multiple_choice` and `other` ask the user to select from a list of options. - `date` expects a date string, in the format `YYYY-MM-DD`. `time` expects a 24-hour hour and minute `HH:mm`. `datetime` expects a full ISO 8601 datetime stamp, `YYYY-MM-DDTHH:mm:ssZ`. Enum: `text`,`email`,`phone`,`integer`,`decimal`,`boolean`,`choice`,`multiple_choice`,`other`,`date`,`time`,`datetime`
text	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
required	boolean
pii	boolean
scope	string	A scope of `booking` is applied once for the whole group. A scope of `guest` is repeated for every guest. Enum: `booking`,`guest`
phase	string	Indicates at which phase of the booking flow an answer is collected. Enum: `hold`,`booking`
options	array[object]	Only populated if type is one of `"choice"` or `"multichoice"`.
label	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
constraints	array[object]
type	string	Enum: `height_cm`,`height_m`,`height_in`,`height_ft`,`weight_kg`,`weight_lb`,`string_length`,`numeric_range`,`selection_count`,`regex`,`purchase_limits`,`per_booking_purchase_limit`,`per_guest_purchase_limit`,`per_product_purchase_limit`,`per_day_purchase_limit`
min	number
max	number
message	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
pattern	string
dependency	object
questionId	string
answer	string

400

Bad Request

401

Unauthorized

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

 
{ "meta": {  "reqId": "5fd78809-4700-46d7-8386-3b8738117f4d" }, "rates": [  {   "cancelable": true,   "code": "MORNING-STD",   "cutoff": 60,   "description": "Perfect for early birds who want to explore the city before the crowds.",   "ext": {    "cancelPolicyDescription": "Full refund available up to 24 hours before start time."   },   "holdable": true,   "holdablePeriod": 600,   "hours": [    {     "daysOfWeek": [      1,      2,      3,      4,      5     ],     "times": [      {       "close": "12:00",       "open": "09:00"      }     ],     "timezone": "America/New_York",     "valid": {      "from": "2023-01-01T00:00:00-05:00",      "until": "2023-12-31T23:59:59-05:00"     }    }   ],   "id": "5fd78809-4700-46d7-8386-3b8738117f4d",   "maxTravelers": 10,   "minTravelers": 1,   "name": "Morning",   "optionId": "5fd78809-4700-46d7-8386-3b8738117f4d",   "partnerId": "9856a211-092e-4ee9-b93c-5e71d1d6f2e7",   "prices": [    {     "id": "5fd78809-4700-46d7-8386-3b8738117f4d",     "name": "Adult",     "net": {      "amount": 3500,      "currency": "USD"     },     "retail": {      "amount": 4000,      "currency": "USD"     },     "status": "ACTIVE",     "travelerType": {      "ageBand": "ADULT",      "maxAge": 99,      "minAge": 18,      "name": "Adult",      "title": "Adult (18-64)",      "description": "Price for a single adult traveler."     },     "unitId": "SY2AB3"    }   ],   "productId": "5fd78809-4700-46d7-8386-3b8738117f4d",   "refundable": true,   "title": "Midtown Quest - Morning Explorer",   "type": "RESERVED",   "valid": {    "from": "2023-01-01T00:00:00-05:00",    "until": "2023-12-31T23:59:59-05:00"   },   "version": 1  } ]}
Copy

Retrieve a single Rate

Returns a Rate. Retrieve information for a specific Rate belonging to a specific parent Product connected to your account using the unique supplier_id, product_id, and rate_id.

🚀 NEW — Booking Questions & Content Capabilities

To retrieve Booking Questions, you must use the bookingQuestions=true query parameter.

To retrieve Content, you must request the specific Rate via its singular endpoint (GET /rates/{id}) using the content=true query parameter.

Auth

Headers

X-Request-ID

string

Path Params

product_id	string
rate_id	string
supplier_id	string

Query String

content	boolean	If set to true, the response will include a 'content' field with detailed metadata. Default: false
locale	string	Comma-separated list of BCP 47 language tags. If specified, only content matching one of these language tags will be returned.
format	string	Comma-separated list of formats. If specified, only content matching one of these formats will be returned. Enum: `plain`,`html`,`markdown`
bookingQuestions	boolean	Includes booking questions field in the response, if available. Default: false

GET /suppliers/{supplier_id}/products/{product_id}/rates/{rate_id}

 
curl --get \ --url 'https://booking.redeam.io/v1.3/suppliers/3434b6e3-eab5-4240-9e6e-cb019eb9b16a/products/cc1d9b14-f6b4-4dba-ad2c-17b35eb71fe2/rates/cf2ce31f-a614-41db-b704-e8c44eff20b7' \ --header 'X-Request-ID: a9a03f82-8080-4772-ada3-dc678b28dfd9' \ --header 'X-API-Key: {X-API-Key}' \ --header 'X-API-Secret: {X-API-Secret}' \ --data content={content} \ --data locale={locale} \ --data format={format} \ --data bookingQuestions={bookingQuestions}
Copy

Responses

200

Retrieve a single Rate

object	object
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string
rate	object
id	uuid	ID of the Rate. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Name used to identify a specific Product Option/Rate or variation
title	string	Customer-facing title for specific Option/Rate.
description	string	A detailed explanation of the specific activity, experience, or event offered in this Option/Rate. This long-form content is meant to appear on Product detail pages, highlighting experience-specific details or restrictions.
code	string	Code of the Rate
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: cancelPolicyDescription: Full refund available up to 24 hours before start time.
productId	uuid	The unique identifier of the parent Product associated with this Rate. This ID matches the `id` field of the parent Product entity and is used to maintain the relational link between the specific Rate option and its high-level Product definition.
optionId	uuid	Operator's internal identifier for this rate. This field's value is not consumed by this API, and this information is provided for informational purposes only.
type	string	Defines the inventory and booking logic for the Rate. `FREESALE` indicates constant availability without fixed capacity limits. `PASS` is used for open-dated entry or multi-use Products. `RESERVED` indicates fixed capacity requiring specific date/time selection. Enum: `FREESALE`,`PASS`,`RESERVED`,`UNKNOWN`
cancelable	boolean	Defines the cancellation policy for this Rate. When `true`, it indicates that bookings made under this Rate are eligible for cancellation.
refundable	boolean	Indicates if a booking made with this Rate is eligible for a monetary refund. This defines the financial policy, whereas `cancelable` defines the operational ability to void a booking.
cutoff	int64	The Rate's "cutoff" property is subtracted from the event's start time (the availability start time) when determining the latest possible time a hold can be made against a particular start time.
holdable	boolean	Indicates whether this Rate supports the creation of a temporary booking hold. If `true`, inventory can be reserved for a limited time to finalize guest details prior to formal confirmation.
holdablePeriod	int64	The maximum duration (in seconds) that a hold remains valid. Resellers must confirm the booking within this window; otherwise, the hold will automatically expire and the inventory will be released.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
maxTravelers	int64	The maximum number of travelers (inclusive) allowed within a single Booking or Hold item. Requests exceeding this limit must be split into separate items or bookings.
minTravelers	int64	The minimum number of travelers (inclusive) required for a single Booking or Hold item. The request will be rejected if the guest count is below this threshold.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
hours	array[object]	The operational or opening hours for the experience. This defines the physical operating window of the venue and is distinct from real-time booking availability or capacity data.
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
prices	array[object]	A list of pricing configurations for this Rate. This defines the cost structure and any applicable Traveler Type distinctions.
id	uuid	Unique identifier for this Rate price
includedTaxes	array[object]	Breakdown of taxes included in the price dedicated to government taxes and fees.
currency	string	The currency code (ISO 4217 format) in which the tax amount is expressed (e.g., "USD", "EUR"). The currency must match the currency used for the item's price (original, net or retails). (required from Supplier) pattern: `^[A-Za-z]{3}$`
id	string	A unique identifier for the tax or fee. Strongly recommended for internal reference and integration purposes. (not required to be a UUID).
name	string	Human-readable title of the included taxes entry. A short, descriptive name for the tax being applied (e.g., "VAT", "City Tax"). The name should be unique. If no tax id is provided, the system will use the combination of name and currency to identify uniqueness. (required from Supplier)
original	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the original price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
net	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the net price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
retail	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the retail price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
labels	array[string]	A list of filterable tags assigned to this price. Used in ChannelBindings (priceTags) to filter prices available by channel.
name	string	Human-readable name for the pricing.
net	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
original	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
retail	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
status	string	Determines if bound channels can list this price. Only 'ACTIVE' prices should be sold. Enum: `ACTIVE`,`INACTIVE`
travelerType	object	Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information.
ageBand	string	The primary age-based category for the traveler. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`STUDENT`,`UNKNOWN`,`YOUTH`
extensions	object	Extended data of the travelerType. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
maxAge	int32	The maximum age (inclusive) allowed for this traveler type.
minAge	int32	The minimum age (inclusive) required for this traveler type.
modifier	string	Additional qualification required for this price. Defaults to 'NONE' unless specific residency or status (e.g., MILITARY) is required. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
name	string	Name of the traveler type, e.g. Diver, Observer, Adult, Military
title	string	Customer-facing title for specific unit/traveler.
description	string	Structured description of the age, membership or role of the traveler this price is intended for.
constraints	array[object]
type	string	The category of the restriction. Enum: `MIN_AGE`,`MAX_AGE`,`MIN_WEIGHT`,`MAX_WEIGHT`,`MIN_HEIGHT`,`MAX_HEIGHT`,`REQUIRED_DOCUMENTS`,`OTHER`
min	number	The minimum value of this constraint.
max	number	The maximum value of this constraint.
unitId	string	Unique identifier for RatePrice which is Supplier specific e.g. Supplier's SKU code
extensions	object	Extended data for the rate price. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information.
content	object	Provides localized, structured, and customer-facing content that can be attached to multiple entities. This object is the primary source for descriptive marketing data across all levels of the catalog. This Content object can be attached to: Suppliers (Company bios, logos) Products (Full experience descriptions, media) Options / Rates (Route or language-specific details) Units / TravelerType (Specific details for Adult, Child, or special TravelerType/Units) The Content object supports multilingual text, rich media, features, FAQs, ratings, and reviews intended for display in Reseller and customer-facing experiences. When present, consumers SHOULD prioritize values from the Content object for display and fall back to the corresponding standard entity fields when content data is not available.
id	string	Unique identifier for this content object. Used to reference and manage content independently of the parent entity.
name	array[object]	A LocalizedTextSet describing the content's name.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
title	array[object]	A LocalizedTextSet describing the content's title.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
subtitle	array[object]	A LocalizedTextSet describing the content's subtitle.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
description	array[object]	A LocalizedTextSet describing the content's description.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
shortDescription	array[object]	A LocalizedTextSet describing the content's short description.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
categories	array[object]	A LocalizedTextSet describing the content's categories.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
duration	object	Indicates the typical or expected duration of the experience. May include a numeric length, unit, and optional localized description.
length	number	Numeric duration value expressed in the specified unit.
flexible	boolean	If `true`, the duration is an estimate (e.g., 'approx. 3 hours'). If `false`, the duration is fixed (e.g., a 45-minute flight).
unit	string	Unit of time used to interpret the duration length. Enum: `minutes`,`hours`,`days`,`weeks`
description	array[object]	A short description of this duration.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
faqs	array[object]
question	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
answer	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
features	array[object]
type	string	Classification of the feature. Enum: `INCLUSION`,`EXCLUSION`,`HIGHLIGHT`,`PREBOOKING_INFORMATION`,`PREARRIVAL_INFORMATION`,`REDEMPTION_INSTRUCTION`,`ACCESSIBILITY_INFORMATION`,`ADDITIONAL_INFORMATION`,`BOOKING_TERMS_AND_CONDITIONS`,`CANCELLATION_TERMS_AND_CONDITIONS`,`TERMS_AND_CONDITIONS`,`RESTRICTION_REQUIREMENT`,`SAFETY_INFORMATION`,`PRIVATE`,`COMMENTARY`,`OTHER`
description	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
media	array[object]
url	string	Direct link to the media asset (image, video, etc.). Must be publicly accessible.
type	string	The media file type. Enum: `image/jpeg`,`image/png`,`image/webp`,`image/svg+xml`,`video/mp4`,`video/avi`,`external/youtube`,`external/vimeo`,`external/other`,`application/pdf`
relationship	string	Describes how the media relates to the object. Examples: "logo" (Supplier branding), "cover" (hero image for Product), "gallery" (set of supplementary visuals). Helps clients render or prioritize media appropriately. Enum: `LOGO`,`COVER`,`GALLERY`,`OTHER`
title	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
caption	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
copyright	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
credits	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
metadata	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
ratings	array[object]
source	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
average	object	Aggregates review scores from sources like Google, TripAdvisor, Yelp, etc. This provides social proof, helping users quickly evaluate the quality and reliability of the experience.
value	number	Rating value.
min	integer	Minimum possible rating.
max	integer	Maximum possible rating.
count	integer	Total number of ratings that contributed to the average. Must be non-negative values (integer ≥ 0).
lastUpdated	date-time	Timestamp of the last time the rating data was refreshed. Format: ISO 8601 (e.g., "2025-06-25T10:00:00Z"). Always use a valid lastUpdated timestamp
reviews	array[object]
reviewerName	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
title	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
content	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
source	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
rating	object	Aggregates review scores from sources like Google, TripAdvisor, Yelp, etc. This provides social proof, helping users quickly evaluate the quality and reliability of the experience.
value	number	Rating value.
min	integer	Minimum possible rating.
max	integer	Maximum possible rating.
createdAt	date-time	Timestamp of when the review was created. Useful for sorting and freshness. Format: ISO 8601 (e.g., "2025-06-25T14:20:00Z").
verified	boolean	Indicates whether the review is from a verified booking or customer. Helps establish credibility and trust.
metadata	object	Additional system-level metadata related to this content, such as timestamps or internal bookkeeping fields.
lastUpdated	date-time	Timestamp indicating when the record was last updated.
locations	array[object]
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
bookingQuestions	array[object]	An array of questions that can be asked during the booking flow. Visible when the `bookableQuestions` query parameter is set to `true`.
id	string
type	string	Describes the format of the answer expected by this question. - `text`, `email` and `phone` are all basic text types. - `integer` and `decimal` are numeric. - `boolean` is true/false. - `choice`, `multiple_choice` and `other` ask the user to select from a list of options. - `date` expects a date string, in the format `YYYY-MM-DD`. `time` expects a 24-hour hour and minute `HH:mm`. `datetime` expects a full ISO 8601 datetime stamp, `YYYY-MM-DDTHH:mm:ssZ`. Enum: `text`,`email`,`phone`,`integer`,`decimal`,`boolean`,`choice`,`multiple_choice`,`other`,`date`,`time`,`datetime`
text	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
required	boolean
pii	boolean
scope	string	A scope of `booking` is applied once for the whole group. A scope of `guest` is repeated for every guest. Enum: `booking`,`guest`
phase	string	Indicates at which phase of the booking flow an answer is collected. Enum: `hold`,`booking`
options	array[object]	Only populated if type is one of `"choice"` or `"multichoice"`.
label	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
constraints	array[object]
type	string	Enum: `height_cm`,`height_m`,`height_in`,`height_ft`,`weight_kg`,`weight_lb`,`string_length`,`numeric_range`,`selection_count`,`regex`,`purchase_limits`,`per_booking_purchase_limit`,`per_guest_purchase_limit`,`per_product_purchase_limit`,`per_day_purchase_limit`
min	number
max	number
message	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
pattern	string
dependency	object
questionId	string
answer	string
content	object	Provides localized, structured, and customer-facing content that can be attached to multiple entities. This object is the primary source for descriptive marketing data across all levels of the catalog. This Content object can be attached to: Suppliers (Company bios, logos) Products (Full experience descriptions, media) Options / Rates (Route or language-specific details) Units / TravelerType (Specific details for Adult, Child, or special TravelerType/Units) The Content object supports multilingual text, rich media, features, FAQs, ratings, and reviews intended for display in Reseller and customer-facing experiences. When present, consumers SHOULD prioritize values from the Content object for display and fall back to the corresponding standard entity fields when content data is not available.
id	string	Unique identifier for this content object. Used to reference and manage content independently of the parent entity.
name	array[object]	A LocalizedTextSet describing the content's name.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
title	array[object]	A LocalizedTextSet describing the content's title.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
subtitle	array[object]	A LocalizedTextSet describing the content's subtitle.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
description	array[object]	A LocalizedTextSet describing the content's description.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
shortDescription	array[object]	A LocalizedTextSet describing the content's short description.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
categories	array[object]	A LocalizedTextSet describing the content's categories.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
duration	object	Indicates the typical or expected duration of the experience. May include a numeric length, unit, and optional localized description.
length	number	Numeric duration value expressed in the specified unit.
flexible	boolean	If `true`, the duration is an estimate (e.g., 'approx. 3 hours'). If `false`, the duration is fixed (e.g., a 45-minute flight).
unit	string	Unit of time used to interpret the duration length. Enum: `minutes`,`hours`,`days`,`weeks`
description	array[object]	A short description of this duration.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
faqs	array[object]
question	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
answer	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
features	array[object]
type	string	Classification of the feature. Enum: `INCLUSION`,`EXCLUSION`,`HIGHLIGHT`,`PREBOOKING_INFORMATION`,`PREARRIVAL_INFORMATION`,`REDEMPTION_INSTRUCTION`,`ACCESSIBILITY_INFORMATION`,`ADDITIONAL_INFORMATION`,`BOOKING_TERMS_AND_CONDITIONS`,`CANCELLATION_TERMS_AND_CONDITIONS`,`TERMS_AND_CONDITIONS`,`RESTRICTION_REQUIREMENT`,`SAFETY_INFORMATION`,`PRIVATE`,`COMMENTARY`,`OTHER`
description	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
media	array[object]
url	string	Direct link to the media asset (image, video, etc.). Must be publicly accessible.
type	string	The media file type. Enum: `image/jpeg`,`image/png`,`image/webp`,`image/svg+xml`,`video/mp4`,`video/avi`,`external/youtube`,`external/vimeo`,`external/other`,`application/pdf`
relationship	string	Describes how the media relates to the object. Examples: "logo" (Supplier branding), "cover" (hero image for Product), "gallery" (set of supplementary visuals). Helps clients render or prioritize media appropriately. Enum: `LOGO`,`COVER`,`GALLERY`,`OTHER`
title	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
caption	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
copyright	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
credits	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
metadata	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
ratings	array[object]
source	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
average	object	Aggregates review scores from sources like Google, TripAdvisor, Yelp, etc. This provides social proof, helping users quickly evaluate the quality and reliability of the experience.
value	number	Rating value.
min	integer	Minimum possible rating.
max	integer	Maximum possible rating.
count	integer	Total number of ratings that contributed to the average. Must be non-negative values (integer ≥ 0).
lastUpdated	date-time	Timestamp of the last time the rating data was refreshed. Format: ISO 8601 (e.g., "2025-06-25T10:00:00Z"). Always use a valid lastUpdated timestamp
reviews	array[object]
reviewerName	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
title	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
content	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
source	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
rating	object	Aggregates review scores from sources like Google, TripAdvisor, Yelp, etc. This provides social proof, helping users quickly evaluate the quality and reliability of the experience.
value	number	Rating value.
min	integer	Minimum possible rating.
max	integer	Maximum possible rating.
createdAt	date-time	Timestamp of when the review was created. Useful for sorting and freshness. Format: ISO 8601 (e.g., "2025-06-25T14:20:00Z").
verified	boolean	Indicates whether the review is from a verified booking or customer. Helps establish credibility and trust.
metadata	object	Additional system-level metadata related to this content, such as timestamps or internal bookkeeping fields.
lastUpdated	date-time	Timestamp indicating when the record was last updated.

401

Unauthorized

404

Not Found

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

xxxxxxxxxx
 
{
 "meta": {...},
 "rate": {...}
}
Copy

Availabilities

GET

/suppliers/{supplier_id}/products/{product_id}/availabilities

GET

/suppliers/{supplier_id}/products/{product_id}/availability

Retrieve a list of availabilities

Returns a list of availabilities. Availabilities will be returned which have a start value in response body greater than or equal to parameter start AND less than or equal to parameter end, if both of these are provided in query string parameters

NOTE: For Rates of type FREESALE, availabilities will only be returned when the rate_id parameter is specified.

The Reseller API accepts a query parameter called granularity, which allows you to define how availability data is grouped. It accepts two values: travelerType or rate. If this value is passed, the availability data is broken down specifically at the ageBand level. This is useful if a Supplier has distinct capacity limits for different guest types.

Auth

Headers

X-Request-ID

string

Path Params

product_id	string
supplier_id	string

Query String

end	string	End of the availability request range, as an RFC3339 date-time.
start	string	Start of the availability request range, as an RFC3339 date-time.
rate_id	string
granularity	string	Defines the granularity level for fetching availabilities. Enum: `travelerType`,`rate`

GET /suppliers/{supplier_id}/products/{product_id}/availabilities

Responses

200

Retrieve a list of availabilities

object	object
availabilities	object
byRate	object	A list of all available windows for the Rate. Availability records by Rate ID.
*	object
availability	array[object]
id	string	A unique identifier for the specific availability slot. This value is passed directly from the supplier. Partners should not attempt to validate it against a UUID regex pattern.
capacity	int32	The number of spots remaining. For open-dated Products, this represents the remaining daily allotment.
maxCapacity	int32	The total capacity for this period. If the maximum capacity has not been set by the operator, then its value will be -1.
start	date-time	The start of the bookable window.
end	date-time	The end of the bookable window.
extensions	object	Extended data of the availability. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information. example: opponentName: vs. New York Yankees
unit_id	string	The availability's Unit ID. Only available when `granularity` is set to `travelerType`.
description	string	Description of the availability object.
expires	date-time	The time at which this availability data is no longer guaranteed to be accurate.
productId	uuid	The ID of the product used in the availability request.
retrieved	date-time	The exact time this availability snapshot was fetched.
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string

400

Bad Request

401

Unauthorized

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

Retrieve a single availability

Validate availability status and remaining capacity for a specific time and quantity. Highly recommended as a final pre-check immediately before placing a Hold. Supports the granularity parameter to break down capacity rules at the traveler type/age band level.

NOTE: For Rates of type FREESALE, an availability will only be returned when the rate_id parameter is specified.

Auth

Headers

X-Request-ID

string

Path Params

product_id	string
supplier_id	string

Query String

at	string	Date Time of availability
qty	integer	Quantity of availability
rate_id	string
granularity	string	To define granularity level for fetching availabilities. Enum: `travelerType`,`rate`

GET /suppliers/{supplier_id}/products/{product_id}/availability

Responses

200

Retrieve a single availability

object	object
availability	object	Represents a bookable window of time. This can refer to a specific timed slot (e.g., 10:00 AM) or a broader validity period for open-dated Products (e.g., a Full Day Pass).
id	string	A unique identifier for the specific availability slot. This value is passed directly from the supplier. Partners should not attempt to validate it against a UUID regex pattern.
capacity	int32	The number of spots remaining. For open-dated Products, this represents the remaining daily allotment.
maxCapacity	int32	The total capacity for this period. If the maximum capacity has not been set by the operator, then its value will be -1.
start	date-time	The start of the bookable window.
end	date-time	The end of the bookable window.
extensions	object	Extended data of the availability. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information. example: opponentName: vs. New York Yankees
unit_id	string	The availability's Unit ID. Only available when `granularity` is set to `travelerType`.
description	string	Description of the availability object.
bookable	boolean	Value is true when a bookable availability is found.
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string

400

Bad Request

401

Unauthorized

404

Not Found

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

Price Schedule

GET

/suppliers/{supplier_id}/products/{product_id}/pricing/schedule

Fetches a price schedule.

Returns a price schedule for the requested Product, if one exists. The expected successful response is a multi-level map; this map has three levels:

A map of Rate IDs (string, UUID) to maps (level 2).
A map of date strings (YYYY-MM-DD) to arrays (level 3).
An array of prices, available under the parent date & belonging to the parent rate_id. A price schedule price MUST be used for any holds made against the price's parent date. If a price has one or more startTimes, that price MUST be used when placing a hold with the same at time.

Auth

Path Params

supplier_id	string	Unique ID of the Supplier
product_id	string	Unique ID of the Product

Query String

start_date	string	Starting date (RFC3339 full-date) of the range to fetch prices for, inclusive.
end_date	string	End date (RFC3339 full-date) of the range to fetch prices for, inclusive. Defaults to 30 days after the `start_date` if not provided. This value MUST be less than one year from the start_date.
rate_id	string	Filter returned prices to those under the specified `rate_id`.

GET /suppliers/{supplier_id}/products/{product_id}/pricing/schedule

Responses

200

A breakdown of prices by Rate and date.

object	object	A map of Rate IDs to dates & prices.
*	object	A map of dates to prices.
*	array[object]	A list of available prices on this Rate and date
id	uuid	The unique identifier for this scheduled price. This ID must be used in booking requests for the matching date/time.
name	string	Human-readable name for the pricing tier.
travelerType	object	Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information.
ageBand	string	The primary age-based category for the traveler. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`STUDENT`,`UNKNOWN`,`YOUTH`
extensions	object	Extended data of the travelerType. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
maxAge	int32	The maximum age (inclusive) allowed for this traveler type.
minAge	int32	The minimum age (inclusive) required for this traveler type.
modifier	string	Additional qualification required for this price. Defaults to 'NONE' unless specific residency or status (e.g., MILITARY) is required. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
name	string	Name of the traveler type, e.g. Diver, Observer, Adult, Military
title	string	Customer-facing title for specific unit/traveler.
description	string	Structured description of the age, membership or role of the traveler this price is intended for.
constraints	array[object]
type	string	The category of the restriction. Enum: `MIN_AGE`,`MAX_AGE`,`MIN_WEIGHT`,`MAX_WEIGHT`,`MIN_HEIGHT`,`MAX_HEIGHT`,`REQUIRED_DOCUMENTS`,`OTHER`
min	number	The minimum value of this constraint.
max	number	The maximum value of this constraint.
unitId	string	Unique identifier for RatePrice which is Supplier specific e.g. Supplier's SKU code
net	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
original	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
retail	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
includedTaxes	object
currency	string	The currency code (ISO 4217 format) in which the tax amount is expressed (e.g., "USD", "EUR"). The currency must match the currency used for the item's price (original, net or retails). (required from Supplier) pattern: `^[A-Za-z]{3}$`
id	string	A unique identifier for the tax or fee. Strongly recommended for internal reference and integration purposes. (not required to be a UUID).
name	string	Human-readable title of the included taxes entry. A short, descriptive name for the tax being applied (e.g., "VAT", "City Tax"). The name should be unique. If no tax id is provided, the system will use the combination of name and currency to identify uniqueness. (required from Supplier)
original	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the original price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
net	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the net price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
retail	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the retail price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
labels	array[string]	A list of filterable tags assigned to this price. Used in ChannelBindings (priceTags) to filter prices available by channel.
startTimes	array[string]	A list of RFC3339 date-times representing the specific start times when this price can be used. The date component of each timestamp in the `startTimes` array MUST match the parent key. If `startTimes` is empty, this price is valid for the entire (local) date represented in the parent key. If `startTimes` is NOT empty, holds made against this price MUST have an `at` time present in the `startTimes` array.
status	string	Determines if bound channels can list this price. Enum: `ACTIVE`,`INACTIVE`

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

Holds

Acquire a hold

A Hold temporarily reserves inventory while a guest completes checkout. Implementing the Hold is mandatory, but not always mandatory to send a Hold before a booking is created. The Hold request requires the supplierId, productId, rateId, priceId, availabilityId, and travelerType from your earlier responses.

If the Hold succeeds, the response includes a holdId and an expires timestamp.

The Hold remains active until it expires, or until you explicitly release it with a DELETE /holds/{hold_id}.

🚀 NEW — Booking Questions Capability

If the Rate includes bookingQuestions[] with phase hold, those answers must be submitted as part of the Hold request body. Required questions (required true) will cause the Hold request to fail if they are omitted. Include an answers array at the Hold level for questions with scope booking, or within each traveler context for questions with scope guest. For questions with scope guest and phase hold, submit the answer inside the relevant items[] or traveler block.

Auth

Headers

X-Request-ID

string

Request Body

object	object
hold	object
id	uuid	Unique identifier for the Hold. If a valid UUID is provided during creation, it will be used as the ID. Otherwise, a system-generated ID is assigned.
extensions	object	Extended data for the hold. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information. example: pickupLocationCode: "PCKUP-2023-8238" beta-ticketLocations: '[{"section":"113","row":"9","seatNumbers":[1,2],"seats":["1","2"]}]'
expires	date-time	The Datetime when the hold expires. Resellers must convert this hold into a Booking before this time; otherwise, the inventory reservation is canceled and released back to the Supplier. A valid RFC3339 expiration date-time MAY be provided in the request, but the value of the expires field in the response MUST take precedence.
items	array[object]	Items in the hold. The list of individual Rate and Price selections currently reserved within this hold.
at	date-time	The intended travel / start date for the hold item, which should match the `start` time on the availability being held.
availabilityId	string	Availability selection for the Hold item
id	uuid	A unique identifier for this hold item, distinct from the ID of the hold itself.
priceId	string	The identifier for the selected price. Selection Rule: * If a price is available on the 'Price Schedule' for the selected date, Rate, and Traveler Type, that ID MUST be used. If no scheduled price exists, the ID from the static Rate 'prices' array MAY be used as a fallback. This field is critical for ensuring the guest is charged the correct seasonal or date-specific Rate.
productId	uuid	The unique identifier of the parent Product associated with this Hold item. This ID matches the `id` field of the parent Product entity.
quantity	int32	Quantity of the hold item. The number of units reserved for this specific line item. Must be within the `minTravelers` and `maxTravelers` constraints defined at the Rate level.
rateId	uuid	Rate ID for the hold item Rate.
supplierId	uuid	The unique identifier of the Supplier that owns and operates this Product. This ID matches the id field of the parent Supplier entity and is used to maintain the relational link between the Supplier's organization and their inventory.
travelerType	string	Traveler type for the Hold item. Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`YOUTH`
ext	object	Extended data for the Hold item. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information. example: childSeat: 'No'
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string

POST /holds

Responses

201

Successfully acquired a hold.

object	object
hold	object
id	uuid	Unique identifier for the Hold. If a valid UUID is provided during creation, it will be used as the ID. Otherwise, a system-generated ID is assigned.
extensions	object	Extended data for the hold. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information. example: pickupLocationCode: "PCKUP-2023-8238" beta-ticketLocations: '[{"section":"113","row":"9","seatNumbers":[1,2],"seats":["1","2"]}]'
expires	date-time	The Datetime when the hold expires. Resellers must convert this hold into a Booking before this time; otherwise, the inventory reservation is canceled and released back to the Supplier. A valid RFC3339 expiration date-time MAY be provided in the request, but the value of the expires field in the response MUST take precedence.
items	array[object]	Items in the hold. The list of individual Rate and Price selections currently reserved within this hold.
at	date-time	The intended travel / start date for the hold item, which should match the `start` time on the availability being held.
availabilityId	string	Availability selection for the Hold item
id	uuid	A unique identifier for this hold item, distinct from the ID of the hold itself.
priceId	string	The identifier for the selected price. Selection Rule: * If a price is available on the 'Price Schedule' for the selected date, Rate, and Traveler Type, that ID MUST be used. If no scheduled price exists, the ID from the static Rate 'prices' array MAY be used as a fallback. This field is critical for ensuring the guest is charged the correct seasonal or date-specific Rate.
productId	uuid	The unique identifier of the parent Product associated with this Hold item. This ID matches the `id` field of the parent Product entity.
quantity	int32	Quantity of the hold item. The number of units reserved for this specific line item. Must be within the `minTravelers` and `maxTravelers` constraints defined at the Rate level.
rateId	uuid	Rate ID for the hold item Rate.
supplierId	uuid	The unique identifier of the Supplier that owns and operates this Product. This ID matches the id field of the parent Supplier entity and is used to maintain the relational link between the Supplier's organization and their inventory.
travelerType	string	Traveler type for the Hold item. Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`YOUTH`
ext	object	Extended data for the Hold item. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information. example: childSeat: 'No'
rate	object
id	uuid	ID of the Rate. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Name used to identify a specific Product Option/Rate or variation
title	string	Customer-facing title for specific Option/Rate.
description	string	A detailed explanation of the specific activity, experience, or event offered in this Option/Rate. This long-form content is meant to appear on Product detail pages, highlighting experience-specific details or restrictions.
code	string	Code of the Rate
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: cancelPolicyDescription: Full refund available up to 24 hours before start time.
productId	uuid	The unique identifier of the parent Product associated with this Rate. This ID matches the `id` field of the parent Product entity and is used to maintain the relational link between the specific Rate option and its high-level Product definition.
optionId	uuid	Operator's internal identifier for this rate. This field's value is not consumed by this API, and this information is provided for informational purposes only.
type	string	Defines the inventory and booking logic for the Rate. `FREESALE` indicates constant availability without fixed capacity limits. `PASS` is used for open-dated entry or multi-use Products. `RESERVED` indicates fixed capacity requiring specific date/time selection. Enum: `FREESALE`,`PASS`,`RESERVED`,`UNKNOWN`
cancelable	boolean	Defines the cancellation policy for this Rate. When `true`, it indicates that bookings made under this Rate are eligible for cancellation.
refundable	boolean	Indicates if a booking made with this Rate is eligible for a monetary refund. This defines the financial policy, whereas `cancelable` defines the operational ability to void a booking.
cutoff	int64	The Rate's "cutoff" property is subtracted from the event's start time (the availability start time) when determining the latest possible time a hold can be made against a particular start time.
holdable	boolean	Indicates whether this Rate supports the creation of a temporary booking hold. If `true`, inventory can be reserved for a limited time to finalize guest details prior to formal confirmation.
holdablePeriod	int64	The maximum duration (in seconds) that a hold remains valid. Resellers must confirm the booking within this window; otherwise, the hold will automatically expire and the inventory will be released.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
maxTravelers	int64	The maximum number of travelers (inclusive) allowed within a single Booking or Hold item. Requests exceeding this limit must be split into separate items or bookings.
minTravelers	int64	The minimum number of travelers (inclusive) required for a single Booking or Hold item. The request will be rejected if the guest count is below this threshold.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
hours	array[object]	The operational or opening hours for the experience. This defines the physical operating window of the venue and is distinct from real-time booking availability or capacity data.
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
prices	array[object]	A list of pricing configurations for this Rate. This defines the cost structure and any applicable Traveler Type distinctions.
id	uuid	Unique identifier for this Rate price
includedTaxes	array[object]	Breakdown of taxes included in the price dedicated to government taxes and fees.
currency	string	The currency code (ISO 4217 format) in which the tax amount is expressed (e.g., "USD", "EUR"). The currency must match the currency used for the item's price (original, net or retails). (required from Supplier) pattern: `^[A-Za-z]{3}$`
id	string	A unique identifier for the tax or fee. Strongly recommended for internal reference and integration purposes. (not required to be a UUID).
name	string	Human-readable title of the included taxes entry. A short, descriptive name for the tax being applied (e.g., "VAT", "City Tax"). The name should be unique. If no tax id is provided, the system will use the combination of name and currency to identify uniqueness. (required from Supplier)
original	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the original price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
net	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the net price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
retail	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the retail price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
labels	array[string]	A list of filterable tags assigned to this price. Used in ChannelBindings (priceTags) to filter prices available by channel.
name	string	Human-readable name for the pricing.
net	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
original	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
retail	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
status	string	Determines if bound channels can list this price. Only 'ACTIVE' prices should be sold. Enum: `ACTIVE`,`INACTIVE`
travelerType	object	Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information.
ageBand	string	The primary age-based category for the traveler. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`STUDENT`,`UNKNOWN`,`YOUTH`
extensions	object	Extended data of the travelerType. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
maxAge	int32	The maximum age (inclusive) allowed for this traveler type.
minAge	int32	The minimum age (inclusive) required for this traveler type.
modifier	string	Additional qualification required for this price. Defaults to 'NONE' unless specific residency or status (e.g., MILITARY) is required. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
name	string	Name of the traveler type, e.g. Diver, Observer, Adult, Military
title	string	Customer-facing title for specific unit/traveler.
description	string	Structured description of the age, membership or role of the traveler this price is intended for.
constraints	array[object]
type	string	The category of the restriction. Enum: `MIN_AGE`,`MAX_AGE`,`MIN_WEIGHT`,`MAX_WEIGHT`,`MIN_HEIGHT`,`MAX_HEIGHT`,`REQUIRED_DOCUMENTS`,`OTHER`
min	number	The minimum value of this constraint.
max	number	The maximum value of this constraint.
unitId	string	Unique identifier for RatePrice which is Supplier specific e.g. Supplier's SKU code
extensions	object	Extended data for the rate price. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information.
locations	array[object]
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
bookingQuestions	array[object]	An array of questions that can be asked during the booking flow. Visible when the `bookableQuestions` query parameter is set to `true`.
id	string
type	string	Describes the format of the answer expected by this question. - `text`, `email` and `phone` are all basic text types. - `integer` and `decimal` are numeric. - `boolean` is true/false. - `choice`, `multiple_choice` and `other` ask the user to select from a list of options. - `date` expects a date string, in the format `YYYY-MM-DD`. `time` expects a 24-hour hour and minute `HH:mm`. `datetime` expects a full ISO 8601 datetime stamp, `YYYY-MM-DDTHH:mm:ssZ`. Enum: `text`,`email`,`phone`,`integer`,`decimal`,`boolean`,`choice`,`multiple_choice`,`other`,`date`,`time`,`datetime`
text	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
required	boolean
pii	boolean
scope	string	A scope of `booking` is applied once for the whole group. A scope of `guest` is repeated for every guest. Enum: `booking`,`guest`
phase	string	Indicates at which phase of the booking flow an answer is collected. Enum: `hold`,`booking`
options	array[object]	Only populated if type is one of `"choice"` or `"multichoice"`.
label	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
constraints	array[object]
type	string	Enum: `height_cm`,`height_m`,`height_in`,`height_ft`,`weight_kg`,`weight_lb`,`string_length`,`numeric_range`,`selection_count`,`regex`,`purchase_limits`,`per_booking_purchase_limit`,`per_guest_purchase_limit`,`per_product_purchase_limit`,`per_day_purchase_limit`
min	number
max	number
message	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
pattern	string
dependency	object
questionId	string
answer	string
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
retrieved	date-time	Datetime of retrieval
status	string	Status of the hold Enum: `ACTIVE`,`EXPIRED`,`FAILED`,`PENDING`,`RELEASED`,`UNKNOWN`
timeline	array[object]	Timeline of actions taken on the Hold.
timestamp	date-time
typeOf	string	Enum: `CANCELLED`,`DELETED`,`OPEN`,`PENDING`,`REDEEMED`,`RELEASED`,`TICKETS_ADDED`,`UNKNOWN`
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string

400

Bad Request

401

Unauthorized

409

Conflict

413

Entity Too Large

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

Retrieve a hold

Retrieve an active Hold by its ID. Returns the same structure as the POST /holds response.

🚀 NEW — Booking Questions Capability

Auth

Headers

X-Request-ID

string

Path Params

hold_id

string

ID of the hold to retrieve.

GET /holds/{hold_id}

Responses

200

Successfully retrieved a hold.

object	object
hold	object
id	uuid	Unique identifier for the Hold. If a valid UUID is provided during creation, it will be used as the ID. Otherwise, a system-generated ID is assigned.
extensions	object	Extended data for the hold. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information. example: pickupLocationCode: "PCKUP-2023-8238" beta-ticketLocations: '[{"section":"113","row":"9","seatNumbers":[1,2],"seats":["1","2"]}]'
expires	date-time	The Datetime when the hold expires. Resellers must convert this hold into a Booking before this time; otherwise, the inventory reservation is canceled and released back to the Supplier. A valid RFC3339 expiration date-time MAY be provided in the request, but the value of the expires field in the response MUST take precedence.
items	array[object]	Items in the hold. The list of individual Rate and Price selections currently reserved within this hold.
at	date-time	The intended travel / start date for the hold item, which should match the `start` time on the availability being held.
availabilityId	string	Availability selection for the Hold item
id	uuid	A unique identifier for this hold item, distinct from the ID of the hold itself.
priceId	string	The identifier for the selected price. Selection Rule: * If a price is available on the 'Price Schedule' for the selected date, Rate, and Traveler Type, that ID MUST be used. If no scheduled price exists, the ID from the static Rate 'prices' array MAY be used as a fallback. This field is critical for ensuring the guest is charged the correct seasonal or date-specific Rate.
productId	uuid	The unique identifier of the parent Product associated with this Hold item. This ID matches the `id` field of the parent Product entity.
quantity	int32	Quantity of the hold item. The number of units reserved for this specific line item. Must be within the `minTravelers` and `maxTravelers` constraints defined at the Rate level.
rateId	uuid	Rate ID for the hold item Rate.
supplierId	uuid	The unique identifier of the Supplier that owns and operates this Product. This ID matches the id field of the parent Supplier entity and is used to maintain the relational link between the Supplier's organization and their inventory.
travelerType	string	Traveler type for the Hold item. Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`YOUTH`
ext	object	Extended data for the Hold item. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information. example: childSeat: 'No'
rate	object
id	uuid	ID of the Rate. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Name used to identify a specific Product Option/Rate or variation
title	string	Customer-facing title for specific Option/Rate.
description	string	A detailed explanation of the specific activity, experience, or event offered in this Option/Rate. This long-form content is meant to appear on Product detail pages, highlighting experience-specific details or restrictions.
code	string	Code of the Rate
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: cancelPolicyDescription: Full refund available up to 24 hours before start time.
productId	uuid	The unique identifier of the parent Product associated with this Rate. This ID matches the `id` field of the parent Product entity and is used to maintain the relational link between the specific Rate option and its high-level Product definition.
optionId	uuid	Operator's internal identifier for this rate. This field's value is not consumed by this API, and this information is provided for informational purposes only.
type	string	Defines the inventory and booking logic for the Rate. `FREESALE` indicates constant availability without fixed capacity limits. `PASS` is used for open-dated entry or multi-use Products. `RESERVED` indicates fixed capacity requiring specific date/time selection. Enum: `FREESALE`,`PASS`,`RESERVED`,`UNKNOWN`
cancelable	boolean	Defines the cancellation policy for this Rate. When `true`, it indicates that bookings made under this Rate are eligible for cancellation.
refundable	boolean	Indicates if a booking made with this Rate is eligible for a monetary refund. This defines the financial policy, whereas `cancelable` defines the operational ability to void a booking.
cutoff	int64	The Rate's "cutoff" property is subtracted from the event's start time (the availability start time) when determining the latest possible time a hold can be made against a particular start time.
holdable	boolean	Indicates whether this Rate supports the creation of a temporary booking hold. If `true`, inventory can be reserved for a limited time to finalize guest details prior to formal confirmation.
holdablePeriod	int64	The maximum duration (in seconds) that a hold remains valid. Resellers must confirm the booking within this window; otherwise, the hold will automatically expire and the inventory will be released.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
maxTravelers	int64	The maximum number of travelers (inclusive) allowed within a single Booking or Hold item. Requests exceeding this limit must be split into separate items or bookings.
minTravelers	int64	The minimum number of travelers (inclusive) required for a single Booking or Hold item. The request will be rejected if the guest count is below this threshold.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
hours	array[object]	The operational or opening hours for the experience. This defines the physical operating window of the venue and is distinct from real-time booking availability or capacity data.
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
prices	array[object]	A list of pricing configurations for this Rate. This defines the cost structure and any applicable Traveler Type distinctions.
id	uuid	Unique identifier for this Rate price
includedTaxes	array[object]	Breakdown of taxes included in the price dedicated to government taxes and fees.
currency	string	The currency code (ISO 4217 format) in which the tax amount is expressed (e.g., "USD", "EUR"). The currency must match the currency used for the item's price (original, net or retails). (required from Supplier) pattern: `^[A-Za-z]{3}$`
id	string	A unique identifier for the tax or fee. Strongly recommended for internal reference and integration purposes. (not required to be a UUID).
name	string	Human-readable title of the included taxes entry. A short, descriptive name for the tax being applied (e.g., "VAT", "City Tax"). The name should be unique. If no tax id is provided, the system will use the combination of name and currency to identify uniqueness. (required from Supplier)
original	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the original price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
net	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the net price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
retail	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the retail price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
labels	array[string]	A list of filterable tags assigned to this price. Used in ChannelBindings (priceTags) to filter prices available by channel.
name	string	Human-readable name for the pricing.
net	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
original	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
retail	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
status	string	Determines if bound channels can list this price. Only 'ACTIVE' prices should be sold. Enum: `ACTIVE`,`INACTIVE`
travelerType	object	Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information.
ageBand	string	The primary age-based category for the traveler. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`STUDENT`,`UNKNOWN`,`YOUTH`
extensions	object	Extended data of the travelerType. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
maxAge	int32	The maximum age (inclusive) allowed for this traveler type.
minAge	int32	The minimum age (inclusive) required for this traveler type.
modifier	string	Additional qualification required for this price. Defaults to 'NONE' unless specific residency or status (e.g., MILITARY) is required. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
name	string	Name of the traveler type, e.g. Diver, Observer, Adult, Military
title	string	Customer-facing title for specific unit/traveler.
description	string	Structured description of the age, membership or role of the traveler this price is intended for.
constraints	array[object]
type	string	The category of the restriction. Enum: `MIN_AGE`,`MAX_AGE`,`MIN_WEIGHT`,`MAX_WEIGHT`,`MIN_HEIGHT`,`MAX_HEIGHT`,`REQUIRED_DOCUMENTS`,`OTHER`
min	number	The minimum value of this constraint.
max	number	The maximum value of this constraint.
unitId	string	Unique identifier for RatePrice which is Supplier specific e.g. Supplier's SKU code
extensions	object	Extended data for the rate price. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information.
locations	array[object]
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
bookingQuestions	array[object]	An array of questions that can be asked during the booking flow. Visible when the `bookableQuestions` query parameter is set to `true`.
id	string
type	string	Describes the format of the answer expected by this question. - `text`, `email` and `phone` are all basic text types. - `integer` and `decimal` are numeric. - `boolean` is true/false. - `choice`, `multiple_choice` and `other` ask the user to select from a list of options. - `date` expects a date string, in the format `YYYY-MM-DD`. `time` expects a 24-hour hour and minute `HH:mm`. `datetime` expects a full ISO 8601 datetime stamp, `YYYY-MM-DDTHH:mm:ssZ`. Enum: `text`,`email`,`phone`,`integer`,`decimal`,`boolean`,`choice`,`multiple_choice`,`other`,`date`,`time`,`datetime`
text	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
required	boolean
pii	boolean
scope	string	A scope of `booking` is applied once for the whole group. A scope of `guest` is repeated for every guest. Enum: `booking`,`guest`
phase	string	Indicates at which phase of the booking flow an answer is collected. Enum: `hold`,`booking`
options	array[object]	Only populated if type is one of `"choice"` or `"multichoice"`.
label	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
constraints	array[object]
type	string	Enum: `height_cm`,`height_m`,`height_in`,`height_ft`,`weight_kg`,`weight_lb`,`string_length`,`numeric_range`,`selection_count`,`regex`,`purchase_limits`,`per_booking_purchase_limit`,`per_guest_purchase_limit`,`per_product_purchase_limit`,`per_day_purchase_limit`
min	number
max	number
message	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
pattern	string
dependency	object
questionId	string
answer	string
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
retrieved	date-time	Datetime of retrieval
status	string	Status of the hold Enum: `ACTIVE`,`EXPIRED`,`FAILED`,`PENDING`,`RELEASED`,`UNKNOWN`
timeline	array[object]	Timeline of actions taken on the Hold.
timestamp	date-time
typeOf	string	Enum: `CANCELLED`,`DELETED`,`OPEN`,`PENDING`,`REDEEMED`,`RELEASED`,`TICKETS_ADDED`,`UNKNOWN`
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string

401

Unauthorized

404

Not Found

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

Release a hold

Release a Hold when a guest abandons their cart or closes the browser. This immediately frees the reserved capacity for other customers rather than waiting for automatic expiry.

Auth

Headers

X-Request-ID

string

Path Params

hold_id

string

ID of the hold to release.

DELETE /holds/{hold_id}

Responses

204

Successfully released a hold.

No response body

401

Unauthorized

404

Not Found

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

Bookings

POST

/bookings

PUT

/bookings/cancel/{booking_id}

GET

/bookings/{booking_id}

Creates a new booking.

A Booking converts a Hold into a confirmed reservation. The Booking request must include the holdId from the preceding Hold response, along with the customer's details and a traveler object for each item (recommended but not mandatory). Travel Curious validates that the Booking request matches the Hold exactly - the supplierId, rateId, priceId, and traveler count must be identical. Any discrepancy causes the Booking to fail.

🚀 NEW — Booking Questions Capability

If the Rate includes bookingQuestions[] with phase booking, those answers must be submitted as part of the Booking request body. Required questions (required true) will cause the Booking request to fail if they are omitted. Include an answers array at the Booking level for questions with scope booking, or within each traveler context for questions with scope guest. For questions with scope guest and phase booing, submit the answer inside the relevant items[] or traveler block.

Auth

Headers

X-Request-ID

string

Request Body

object	object
booking	object	The primary container for a transaction. It links a customer to one or more booking items and manages the overall lifecycle, fulfillment, and cancellation eligibility.
barcode	object	Contains the digital fulfillment data for a ticket. This information is used to generate the visual or textual voucher presented at the venue.
format	string	The technical format or symbology of the barcode. This dictates how the Reseller should render the barcode image or text on the guest's ticket. Enum: `UNKNOWN`,`QR_CODE`,`EAN13`,`CODE128`,`UPCA`,`TEXT`,`CODE39`,`URL`,`INTERLEAVED`
value	string	The actual data string encoded in the barcode. This is the unique identifier that the venue's scanner will read.
id	uuid	Unique identifier for the booking. If a valid UUID is provided during creation, it will be used as the ID. Otherwise, a system-generated ID is assigned.
holdId	uuid	The ID of a temporary hold. Provide this to convert a reserved inventory slot into a confirmed booking.
cancelable	boolean	Indicates if the booking can currently be canceled. This is calculated based on the 'cancelable' property of the underlying Rates and the applicable cutoff windows.
customer	object	Information about the lead customer responsible for the booking. This data is used for fulfillment, communication, and manifest records.
email	string	The primary contact email. Used for voucher delivery and operational updates.
firstName	string	The first name of the lead traveler.
lastName	string	The last name of the lead traveler.
phone	string	Phone number of the lead customer. Please follow this style guide when formatting phone numbers: https://developers.google.com/style/phone-numbers
country	string	This MUST be a valid ISO 3166-1 alpha-2 or alpha-3 country code of the customer (e.g., USA, GBR, CAN).
extensions	object	Supplemental customer data, such as secondary contact info. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
*	string
extensions	object	Extended data for the booking item. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: pickupLocationCode: PCKUP-2023-8238
items	array[object]	Single or list of individual items within this booking.
id	uuid	Booking Item ID. The unique identifier for this line item.
availabilityId	string	The identifier for the specific availability slot selected. This ensures the booking is tied to a valid, high-integrity inventory record.
priceId	string	The identifier for the selected price. Selection Rule: * If a price is available on the 'Price Schedule' for the selected date, Rate, and Traveler Type, that ID MUST be used. If no scheduled price exists, the ID from the static Rate 'prices' array MAY be used as a fallback. This field is critical for ensuring the guest is charged the correct seasonal or date-specific Rate.
productId	uuid	The unique identifier of the parent Product associated with this Rate. This ID matches the 'id' field of the parent Product entity and is used to maintain the relational link between the specific Rate option and its high-level Product definition.
quantity	int32	Quantity of the booking item. The number of units reserved for this specific line item. Must be within the `minTravelers` and `maxTravelers` constraints defined at the Rate level.
rate	object
id	uuid	ID of the Rate. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Name used to identify a specific Product Option/Rate or variation
title	string	Customer-facing title for specific Option/Rate.
description	string	A detailed explanation of the specific activity, experience, or event offered in this Option/Rate. This long-form content is meant to appear on Product detail pages, highlighting experience-specific details or restrictions.
code	string	Code of the Rate
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: cancelPolicyDescription: Full refund available up to 24 hours before start time.
productId	uuid	The unique identifier of the parent Product associated with this Rate. This ID matches the `id` field of the parent Product entity and is used to maintain the relational link between the specific Rate option and its high-level Product definition.
optionId	uuid	Operator's internal identifier for this rate. This field's value is not consumed by this API, and this information is provided for informational purposes only.
type	string	Defines the inventory and booking logic for the Rate. `FREESALE` indicates constant availability without fixed capacity limits. `PASS` is used for open-dated entry or multi-use Products. `RESERVED` indicates fixed capacity requiring specific date/time selection. Enum: `FREESALE`,`PASS`,`RESERVED`,`UNKNOWN`
cancelable	boolean	Defines the cancellation policy for this Rate. When `true`, it indicates that bookings made under this Rate are eligible for cancellation.
refundable	boolean	Indicates if a booking made with this Rate is eligible for a monetary refund. This defines the financial policy, whereas `cancelable` defines the operational ability to void a booking.
cutoff	int64	The Rate's "cutoff" property is subtracted from the event's start time (the availability start time) when determining the latest possible time a hold can be made against a particular start time.
holdable	boolean	Indicates whether this Rate supports the creation of a temporary booking hold. If `true`, inventory can be reserved for a limited time to finalize guest details prior to formal confirmation.
holdablePeriod	int64	The maximum duration (in seconds) that a hold remains valid. Resellers must confirm the booking within this window; otherwise, the hold will automatically expire and the inventory will be released.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
maxTravelers	int64	The maximum number of travelers (inclusive) allowed within a single Booking or Hold item. Requests exceeding this limit must be split into separate items or bookings.
minTravelers	int64	The minimum number of travelers (inclusive) required for a single Booking or Hold item. The request will be rejected if the guest count is below this threshold.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
hours	array[object]	The operational or opening hours for the experience. This defines the physical operating window of the venue and is distinct from real-time booking availability or capacity data.
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
prices	array[object]	A list of pricing configurations for this Rate. This defines the cost structure and any applicable Traveler Type distinctions.
id	uuid	Unique identifier for this Rate price
includedTaxes	array[object]	Breakdown of taxes included in the price dedicated to government taxes and fees.
currency	string	The currency code (ISO 4217 format) in which the tax amount is expressed (e.g., "USD", "EUR"). The currency must match the currency used for the item's price (original, net or retails). (required from Supplier) pattern: `^[A-Za-z]{3}$`
id	string	A unique identifier for the tax or fee. Strongly recommended for internal reference and integration purposes. (not required to be a UUID).
name	string	Human-readable title of the included taxes entry. A short, descriptive name for the tax being applied (e.g., "VAT", "City Tax"). The name should be unique. If no tax id is provided, the system will use the combination of name and currency to identify uniqueness. (required from Supplier)
original	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the original price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
net	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the net price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
retail	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the retail price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
labels	array[string]	A list of filterable tags assigned to this price. Used in ChannelBindings (priceTags) to filter prices available by channel.
name	string	Human-readable name for the pricing.
net	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
original	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
retail	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
status	string	Determines if bound channels can list this price. Only 'ACTIVE' prices should be sold. Enum: `ACTIVE`,`INACTIVE`
travelerType	object	Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information.
ageBand	string	The primary age-based category for the traveler. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`STUDENT`,`UNKNOWN`,`YOUTH`
extensions	object	Extended data of the travelerType. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
maxAge	int32	The maximum age (inclusive) allowed for this traveler type.
minAge	int32	The minimum age (inclusive) required for this traveler type.
modifier	string	Additional qualification required for this price. Defaults to 'NONE' unless specific residency or status (e.g., MILITARY) is required. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
name	string	Name of the traveler type, e.g. Diver, Observer, Adult, Military
title	string	Customer-facing title for specific unit/traveler.
description	string	Structured description of the age, membership or role of the traveler this price is intended for.
constraints	array[object]
type	string	The category of the restriction. Enum: `MIN_AGE`,`MAX_AGE`,`MIN_WEIGHT`,`MAX_WEIGHT`,`MIN_HEIGHT`,`MAX_HEIGHT`,`REQUIRED_DOCUMENTS`,`OTHER`
min	number	The minimum value of this constraint.
max	number	The maximum value of this constraint.
unitId	string	Unique identifier for RatePrice which is Supplier specific e.g. Supplier's SKU code
extensions	object	Extended data for the rate price. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information.
locations	array[object]
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
bookingQuestions	array[object]	An array of questions that can be asked during the booking flow. Visible when the `bookableQuestions` query parameter is set to `true`.
id	string
type	string	Describes the format of the answer expected by this question. - `text`, `email` and `phone` are all basic text types. - `integer` and `decimal` are numeric. - `boolean` is true/false. - `choice`, `multiple_choice` and `other` ask the user to select from a list of options. - `date` expects a date string, in the format `YYYY-MM-DD`. `time` expects a 24-hour hour and minute `HH:mm`. `datetime` expects a full ISO 8601 datetime stamp, `YYYY-MM-DDTHH:mm:ssZ`. Enum: `text`,`email`,`phone`,`integer`,`decimal`,`boolean`,`choice`,`multiple_choice`,`other`,`date`,`time`,`datetime`
text	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
required	boolean
pii	boolean
scope	string	A scope of `booking` is applied once for the whole group. A scope of `guest` is repeated for every guest. Enum: `booking`,`guest`
phase	string	Indicates at which phase of the booking flow an answer is collected. Enum: `hold`,`booking`
options	array[object]	Only populated if type is one of `"choice"` or `"multichoice"`.
label	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
constraints	array[object]
type	string	Enum: `height_cm`,`height_m`,`height_in`,`height_ft`,`weight_kg`,`weight_lb`,`string_length`,`numeric_range`,`selection_count`,`regex`,`purchase_limits`,`per_booking_purchase_limit`,`per_guest_purchase_limit`,`per_product_purchase_limit`,`per_day_purchase_limit`
min	number
max	number
message	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
pattern	string
dependency	object
questionId	string
answer	string
rateId	uuid	ID of the Rate. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
startTime	date-time	The scheduled start date and time for the experience. Must align with a valid availability slot for the selected Rate.
supplierId	uuid	The unique identifier of the Supplier that owns and operates this Product. This ID matches the id field of the parent Supplier entity and is used to maintain the relational link between the Supplier's organization and their inventory.
ext	object	Extended data for the booking item. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: childSeat: 'No'
traveler	object	Individual participant details for the booking. These details are used for manifests, eligibility verification, and on-site identification.
firstName	string	First name of the individual traveler.
lastName	string	Last name of the individual traveler.
email	string	Individual email address, if different from the lead customer.
age	int32	Actual age of the traveler in years.
country	string	This MUST be a valid ISO 3166-1 alpha-2 or alpha-3 country code of the customer (e.g., USA, GBR, CAN). pattern: `^[A-Za-z]{3}$`
gender	string	Gender of the traveler. Enum: `FEMALE`,`MALE`
isLead	boolean	Indicates if this is the primary traveler for the item. Each Booking Item must have exactly one lead traveler.
lang	string	Spoken language as an ISO 639-3 code (e.g., ENG, FRA, DEU). code' pattern: `^[A-Za-z]{3}$`
phone	string	Phone number of the lead customer. Please follow this style guide when formatting phone numbers: https://developers.google.com/style/phone-numbers pattern: `^\+\d[\d\s-]+$`
extensions	object	Supplemental data such as dietary requirements or accessibility needs. Extensions may be used to exchange required operational or commercial information. example: specialRequest: Wheelchair accessibility
*	string
type	string	Matches the 'ageBand' from the RatePrice (e.g., ADULT, CHILD). Used for price validation.
answers	array[object]
question_id	string
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
resellerBookingRef	string	Reseller reference ID for the booking, used by the Reseller API client to provide their own reference for the booking.
answers	array[object]
question_id	string
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string

POST /bookings

Responses

201

Successfully creates a new booking.

object	object
booking	object	The primary container for a transaction. It links a customer to one or more booking items and manages the overall lifecycle, fulfillment, and cancellation eligibility.
barcode	object	Contains the digital fulfillment data for a ticket. This information is used to generate the visual or textual voucher presented at the venue.
format	string	The technical format or symbology of the barcode. This dictates how the Reseller should render the barcode image or text on the guest's ticket. Enum: `UNKNOWN`,`QR_CODE`,`EAN13`,`CODE128`,`UPCA`,`TEXT`,`CODE39`,`URL`,`INTERLEAVED`
value	string	The actual data string encoded in the barcode. This is the unique identifier that the venue's scanner will read.
id	uuid	Unique identifier for the booking. If a valid UUID is provided during creation, it will be used as the ID. Otherwise, a system-generated ID is assigned.
holdId	uuid	The ID of a temporary hold. Provide this to convert a reserved inventory slot into a confirmed booking.
cancelable	boolean	Indicates if the booking can currently be canceled. This is calculated based on the 'cancelable' property of the underlying Rates and the applicable cutoff windows.
customer	object	Information about the lead customer responsible for the booking. This data is used for fulfillment, communication, and manifest records.
email	string	The primary contact email. Used for voucher delivery and operational updates.
firstName	string	The first name of the lead traveler.
lastName	string	The last name of the lead traveler.
phone	string	Phone number of the lead customer. Please follow this style guide when formatting phone numbers: https://developers.google.com/style/phone-numbers
country	string	This MUST be a valid ISO 3166-1 alpha-2 or alpha-3 country code of the customer (e.g., USA, GBR, CAN).
extensions	object	Supplemental customer data, such as secondary contact info. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
*	string
extensions	object	Extended data for the booking item. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: pickupLocationCode: PCKUP-2023-8238
items	array[object]	Single or list of individual items within this booking.
id	uuid	Booking Item ID. The unique identifier for this line item.
availabilityId	string	The identifier for the specific availability slot selected. This ensures the booking is tied to a valid, high-integrity inventory record.
priceId	string	The identifier for the selected price. Selection Rule: * If a price is available on the 'Price Schedule' for the selected date, Rate, and Traveler Type, that ID MUST be used. If no scheduled price exists, the ID from the static Rate 'prices' array MAY be used as a fallback. This field is critical for ensuring the guest is charged the correct seasonal or date-specific Rate.
productId	uuid	The unique identifier of the parent Product associated with this Rate. This ID matches the 'id' field of the parent Product entity and is used to maintain the relational link between the specific Rate option and its high-level Product definition.
quantity	int32	Quantity of the booking item. The number of units reserved for this specific line item. Must be within the `minTravelers` and `maxTravelers` constraints defined at the Rate level.
rate	object
id	uuid	ID of the Rate. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Name used to identify a specific Product Option/Rate or variation
title	string	Customer-facing title for specific Option/Rate.
description	string	A detailed explanation of the specific activity, experience, or event offered in this Option/Rate. This long-form content is meant to appear on Product detail pages, highlighting experience-specific details or restrictions.
code	string	Code of the Rate
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: cancelPolicyDescription: Full refund available up to 24 hours before start time.
productId	uuid	The unique identifier of the parent Product associated with this Rate. This ID matches the `id` field of the parent Product entity and is used to maintain the relational link between the specific Rate option and its high-level Product definition.
optionId	uuid	Operator's internal identifier for this rate. This field's value is not consumed by this API, and this information is provided for informational purposes only.
type	string	Defines the inventory and booking logic for the Rate. `FREESALE` indicates constant availability without fixed capacity limits. `PASS` is used for open-dated entry or multi-use Products. `RESERVED` indicates fixed capacity requiring specific date/time selection. Enum: `FREESALE`,`PASS`,`RESERVED`,`UNKNOWN`
cancelable	boolean	Defines the cancellation policy for this Rate. When `true`, it indicates that bookings made under this Rate are eligible for cancellation.
refundable	boolean	Indicates if a booking made with this Rate is eligible for a monetary refund. This defines the financial policy, whereas `cancelable` defines the operational ability to void a booking.
cutoff	int64	The Rate's "cutoff" property is subtracted from the event's start time (the availability start time) when determining the latest possible time a hold can be made against a particular start time.
holdable	boolean	Indicates whether this Rate supports the creation of a temporary booking hold. If `true`, inventory can be reserved for a limited time to finalize guest details prior to formal confirmation.
holdablePeriod	int64	The maximum duration (in seconds) that a hold remains valid. Resellers must confirm the booking within this window; otherwise, the hold will automatically expire and the inventory will be released.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
maxTravelers	int64	The maximum number of travelers (inclusive) allowed within a single Booking or Hold item. Requests exceeding this limit must be split into separate items or bookings.
minTravelers	int64	The minimum number of travelers (inclusive) required for a single Booking or Hold item. The request will be rejected if the guest count is below this threshold.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
hours	array[object]	The operational or opening hours for the experience. This defines the physical operating window of the venue and is distinct from real-time booking availability or capacity data.
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
prices	array[object]	A list of pricing configurations for this Rate. This defines the cost structure and any applicable Traveler Type distinctions.
id	uuid	Unique identifier for this Rate price
includedTaxes	array[object]	Breakdown of taxes included in the price dedicated to government taxes and fees.
currency	string	The currency code (ISO 4217 format) in which the tax amount is expressed (e.g., "USD", "EUR"). The currency must match the currency used for the item's price (original, net or retails). (required from Supplier) pattern: `^[A-Za-z]{3}$`
id	string	A unique identifier for the tax or fee. Strongly recommended for internal reference and integration purposes. (not required to be a UUID).
name	string	Human-readable title of the included taxes entry. A short, descriptive name for the tax being applied (e.g., "VAT", "City Tax"). The name should be unique. If no tax id is provided, the system will use the combination of name and currency to identify uniqueness. (required from Supplier)
original	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the original price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
net	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the net price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
retail	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the retail price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
labels	array[string]	A list of filterable tags assigned to this price. Used in ChannelBindings (priceTags) to filter prices available by channel.
name	string	Human-readable name for the pricing.
net	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
original	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
retail	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
status	string	Determines if bound channels can list this price. Only 'ACTIVE' prices should be sold. Enum: `ACTIVE`,`INACTIVE`
travelerType	object	Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information.
ageBand	string	The primary age-based category for the traveler. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`STUDENT`,`UNKNOWN`,`YOUTH`
extensions	object	Extended data of the travelerType. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
maxAge	int32	The maximum age (inclusive) allowed for this traveler type.
minAge	int32	The minimum age (inclusive) required for this traveler type.
modifier	string	Additional qualification required for this price. Defaults to 'NONE' unless specific residency or status (e.g., MILITARY) is required. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
name	string	Name of the traveler type, e.g. Diver, Observer, Adult, Military
title	string	Customer-facing title for specific unit/traveler.
description	string	Structured description of the age, membership or role of the traveler this price is intended for.
constraints	array[object]
type	string	The category of the restriction. Enum: `MIN_AGE`,`MAX_AGE`,`MIN_WEIGHT`,`MAX_WEIGHT`,`MIN_HEIGHT`,`MAX_HEIGHT`,`REQUIRED_DOCUMENTS`,`OTHER`
min	number	The minimum value of this constraint.
max	number	The maximum value of this constraint.
unitId	string	Unique identifier for RatePrice which is Supplier specific e.g. Supplier's SKU code
extensions	object	Extended data for the rate price. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information.
locations	array[object]
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
bookingQuestions	array[object]	An array of questions that can be asked during the booking flow. Visible when the `bookableQuestions` query parameter is set to `true`.
id	string
type	string	Describes the format of the answer expected by this question. - `text`, `email` and `phone` are all basic text types. - `integer` and `decimal` are numeric. - `boolean` is true/false. - `choice`, `multiple_choice` and `other` ask the user to select from a list of options. - `date` expects a date string, in the format `YYYY-MM-DD`. `time` expects a 24-hour hour and minute `HH:mm`. `datetime` expects a full ISO 8601 datetime stamp, `YYYY-MM-DDTHH:mm:ssZ`. Enum: `text`,`email`,`phone`,`integer`,`decimal`,`boolean`,`choice`,`multiple_choice`,`other`,`date`,`time`,`datetime`
text	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
required	boolean
pii	boolean
scope	string	A scope of `booking` is applied once for the whole group. A scope of `guest` is repeated for every guest. Enum: `booking`,`guest`
phase	string	Indicates at which phase of the booking flow an answer is collected. Enum: `hold`,`booking`
options	array[object]	Only populated if type is one of `"choice"` or `"multichoice"`.
label	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
constraints	array[object]
type	string	Enum: `height_cm`,`height_m`,`height_in`,`height_ft`,`weight_kg`,`weight_lb`,`string_length`,`numeric_range`,`selection_count`,`regex`,`purchase_limits`,`per_booking_purchase_limit`,`per_guest_purchase_limit`,`per_product_purchase_limit`,`per_day_purchase_limit`
min	number
max	number
message	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
pattern	string
dependency	object
questionId	string
answer	string
rateId	uuid	ID of the Rate. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
startTime	date-time	The scheduled start date and time for the experience. Must align with a valid availability slot for the selected Rate.
status	string	The current lifecycle state of the booking item. `OPEN`: Active and valid for travel. `REDEEMED`: Guest has checked in or ticket was scanned. `CANCELLED`: Item is voided but record remains. `REFUNDED`: Item is voided and funds returned. `EXPIRED`: Validity window passed without redemption or confirmation. `DELETED`: Removed from a hold before finalization. `UNKNOWN`: State is undefined or out of sync. Enum: `CANCELLED`,`DELETED`,`EXPIRED`,`OPEN`,`REDEEMED`,`REFUNDED`,`UNKNOWN`
supplierId	uuid	The unique identifier of the Supplier that owns and operates this Product. This ID matches the id field of the parent Supplier entity and is used to maintain the relational link between the Supplier's organization and their inventory.
ext	object	Extended data for the booking item. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: childSeat: 'No'
traveler	object	Individual participant details for the booking. These details are used for manifests, eligibility verification, and on-site identification.
firstName	string	First name of the individual traveler.
lastName	string	Last name of the individual traveler.
email	string	Individual email address, if different from the lead customer.
age	int32	Actual age of the traveler in years.
country	string	This MUST be a valid ISO 3166-1 alpha-2 or alpha-3 country code of the customer (e.g., USA, GBR, CAN). pattern: `^[A-Za-z]{3}$`
gender	string	Gender of the traveler. Enum: `FEMALE`,`MALE`
isLead	boolean	Indicates if this is the primary traveler for the item. Each Booking Item must have exactly one lead traveler.
lang	string	Spoken language as an ISO 639-3 code (e.g., ENG, FRA, DEU). code' pattern: `^[A-Za-z]{3}$`
phone	string	Phone number of the lead customer. Please follow this style guide when formatting phone numbers: https://developers.google.com/style/phone-numbers pattern: `^\+\d[\d\s-]+$`
extensions	object	Supplemental data such as dietary requirements or accessibility needs. Extensions may be used to exchange required operational or commercial information. example: specialRequest: Wheelchair accessibility
*	string
type	string	Matches the 'ageBand' from the RatePrice (e.g., ADULT, CHILD). Used for price validation.
answers	array[object]
question_id	string
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
resellerBookingRef	string	Reseller reference ID for the booking, used by the Reseller API client to provide their own reference for the booking.
status	string	The overall status of the booking. `OPEN`: Confirmed and active. `PENDING`: Awaiting final processing. `OLCI_PENDING`: Awaiting online check-in. `FAILED`: Booking was not successful. `REDEEMED`: All items have been scanned. `CANCELLED`: Entire booking is voided. Enum: `CANCELLED`,`DELETED`,`FAILED`,`OPEN`,`PENDING`,`REDEEMED`,`UNKNOWN`
tickets	array[object]	Tickets for the booking. The reservation system is ultimately responsible for the number of tickets being returned, and the value each ticket is redeemable for. Tickets usually represent a single item or group of items, but this varies from system to system. Please contact the reservation system you are connecting to for additional details on how their response tickets are structured.
barcode	object	Contains the digital fulfillment data for a ticket. This information is used to generate the visual or textual voucher presented at the venue.
format	string	The technical format or symbology of the barcode. This dictates how the Reseller should render the barcode image or text on the guest's ticket. Enum: `UNKNOWN`,`QR_CODE`,`EAN13`,`CODE128`,`UPCA`,`TEXT`,`CODE39`,`URL`,`INTERLEAVED`
value	string	The actual data string encoded in the barcode. This is the unique identifier that the venue's scanner will read.
bookingItemIds	array[string]	One or more references to Booking Item IDs.
guests	array[object]	The number of guests for this ticket.
count	integer	Number of guests.
typeCode	string	This should contain the `Rate.Prices[].Traveler.AgeBand` from the Price referenced by the Booking Item that corresponds to this ticket. Enum: `INFANT`,`CHILD`,`YOUTH`,`ADULT`,`SENIOR`,`STUDENT`,`ANY`
typeModifier	string	This should contain the `Rate.Prices[].Traveler.Modifier` from the Price referenced by the Booking Item that corresponds to this ticket. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
typeName	string	This should contain the `Rate.Prices[].Traveler.Name` from the Price referenced by the Booking Item that corresponds to this ticket.
leadTraveler	object	Individual participant details for the booking. These details are used for manifests, eligibility verification, and on-site identification.
firstName	string	First name of the individual traveler.
lastName	string	Last name of the individual traveler.
email	string	Individual email address, if different from the lead customer.
age	int32	Actual age of the traveler in years.
country	string	This MUST be a valid ISO 3166-1 alpha-2 or alpha-3 country code of the customer (e.g., USA, GBR, CAN). pattern: `^[A-Za-z]{3}$`
gender	string	Gender of the traveler. Enum: `FEMALE`,`MALE`
isLead	boolean	Indicates if this is the primary traveler for the item. Each Booking Item must have exactly one lead traveler.
lang	string	Spoken language as an ISO 639-3 code (e.g., ENG, FRA, DEU). code' pattern: `^[A-Za-z]{3}$`
phone	string	Phone number of the lead customer. Please follow this style guide when formatting phone numbers: https://developers.google.com/style/phone-numbers pattern: `^\+\d[\d\s-]+$`
extensions	object	Supplemental data such as dietary requirements or accessibility needs. Extensions may be used to exchange required operational or commercial information. example: specialRequest: Wheelchair accessibility
*	string
type	string	Matches the 'ageBand' from the RatePrice (e.g., ADULT, CHILD). Used for price validation.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: additionalTicketInfo: Carry Prints
status	string	Ticket status Enum: `CANCELLED`,`DELETED`,`EXPIRED`,`OPEN`,`REDEEMED`,`REFUNDED`,`UNKNOWN`
timeline	array[object]	Timeline of actions taken on the Booking.
timestamp	date-time
typeOf	string	Enum: `CANCELLED`,`DELETED`,`OPEN`,`PENDING`,`REDEEMED`,`RELEASED`,`TICKETS_ADDED`,`UNKNOWN`
version	int32	Internal version number
answers	array[object]
question_id	string
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string

400

Bad Request

401

Unauthorized

409

Conflict

413

Entity Too Large

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

Cancel an existing booking.

Auth

Headers

X-Request-ID

string

Path Params

booking_id

string

ID of the booking to cancel.

Request Body

object object

reason

string

This value indicates the reason that the cancellation request was sent.

CUSTOMER is the most common and indicates that the customer requested the cancellation.
SUPPLIER indicates that the Supplier requested the cancellation (possibly due to bad weather or other unexpected circumstances).
FRAUD indicates that the booking cancellation is being requested by the Reseller because it has been determined the booking was fraudulent.
OTHER indicates that the cancellation reason does not fall into one of these categories. This SHOULD be used only in rare circumstances.

Enum: CUSTOMER,SUPPLIER,FRAUD,OTHER

reasonDetails

string

This field provides additional details about the reason for the cancellation request. It may include information from the customer, Supplier, or support agent about the reason for the cancellation (especially in the case of requesting a cancellation outside of the normal policy which may require manual approval from the Supplier).

PUT /bookings/cancel/{booking_id}

Responses

204

Cancel a booking

No response body

400

Bad Request

401

Unauthorized

404

Not Found

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

Retrieve a single booking.

Auth

Headers

X-Request-ID

string

Path Params

booking_id

string

ID of the booking to retrieve.

GET /bookings/{booking_id}

Responses

200

Retrieve a single booking

object	object
booking	object	The primary container for a transaction. It links a customer to one or more booking items and manages the overall lifecycle, fulfillment, and cancellation eligibility.
barcode	object	Contains the digital fulfillment data for a ticket. This information is used to generate the visual or textual voucher presented at the venue.
format	string	The technical format or symbology of the barcode. This dictates how the Reseller should render the barcode image or text on the guest's ticket. Enum: `UNKNOWN`,`QR_CODE`,`EAN13`,`CODE128`,`UPCA`,`TEXT`,`CODE39`,`URL`,`INTERLEAVED`
value	string	The actual data string encoded in the barcode. This is the unique identifier that the venue's scanner will read.
id	uuid	Unique identifier for the booking. If a valid UUID is provided during creation, it will be used as the ID. Otherwise, a system-generated ID is assigned.
holdId	uuid	The ID of a temporary hold. Provide this to convert a reserved inventory slot into a confirmed booking.
cancelable	boolean	Indicates if the booking can currently be canceled. This is calculated based on the 'cancelable' property of the underlying Rates and the applicable cutoff windows.
customer	object	Information about the lead customer responsible for the booking. This data is used for fulfillment, communication, and manifest records.
email	string	The primary contact email. Used for voucher delivery and operational updates.
firstName	string	The first name of the lead traveler.
lastName	string	The last name of the lead traveler.
phone	string	Phone number of the lead customer. Please follow this style guide when formatting phone numbers: https://developers.google.com/style/phone-numbers
country	string	This MUST be a valid ISO 3166-1 alpha-2 or alpha-3 country code of the customer (e.g., USA, GBR, CAN).
extensions	object	Supplemental customer data, such as secondary contact info. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
*	string
extensions	object	Extended data for the booking item. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: pickupLocationCode: PCKUP-2023-8238
items	array[object]	Single or list of individual items within this booking.
id	uuid	Booking Item ID. The unique identifier for this line item.
availabilityId	string	The identifier for the specific availability slot selected. This ensures the booking is tied to a valid, high-integrity inventory record.
priceId	string	The identifier for the selected price. Selection Rule: * If a price is available on the 'Price Schedule' for the selected date, Rate, and Traveler Type, that ID MUST be used. If no scheduled price exists, the ID from the static Rate 'prices' array MAY be used as a fallback. This field is critical for ensuring the guest is charged the correct seasonal or date-specific Rate.
productId	uuid	The unique identifier of the parent Product associated with this Rate. This ID matches the 'id' field of the parent Product entity and is used to maintain the relational link between the specific Rate option and its high-level Product definition.
quantity	int32	Quantity of the booking item. The number of units reserved for this specific line item. Must be within the `minTravelers` and `maxTravelers` constraints defined at the Rate level.
rate	object
id	uuid	ID of the Rate. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
name	string	Name used to identify a specific Product Option/Rate or variation
title	string	Customer-facing title for specific Option/Rate.
description	string	A detailed explanation of the specific activity, experience, or event offered in this Option/Rate. This long-form content is meant to appear on Product detail pages, highlighting experience-specific details or restrictions.
code	string	Code of the Rate
version	int32	Version of this object. Increments every update.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: cancelPolicyDescription: Full refund available up to 24 hours before start time.
productId	uuid	The unique identifier of the parent Product associated with this Rate. This ID matches the `id` field of the parent Product entity and is used to maintain the relational link between the specific Rate option and its high-level Product definition.
optionId	uuid	Operator's internal identifier for this rate. This field's value is not consumed by this API, and this information is provided for informational purposes only.
type	string	Defines the inventory and booking logic for the Rate. `FREESALE` indicates constant availability without fixed capacity limits. `PASS` is used for open-dated entry or multi-use Products. `RESERVED` indicates fixed capacity requiring specific date/time selection. Enum: `FREESALE`,`PASS`,`RESERVED`,`UNKNOWN`
cancelable	boolean	Defines the cancellation policy for this Rate. When `true`, it indicates that bookings made under this Rate are eligible for cancellation.
refundable	boolean	Indicates if a booking made with this Rate is eligible for a monetary refund. This defines the financial policy, whereas `cancelable` defines the operational ability to void a booking.
cutoff	int64	The Rate's "cutoff" property is subtracted from the event's start time (the availability start time) when determining the latest possible time a hold can be made against a particular start time.
holdable	boolean	Indicates whether this Rate supports the creation of a temporary booking hold. If `true`, inventory can be reserved for a limited time to finalize guest details prior to formal confirmation.
holdablePeriod	int64	The maximum duration (in seconds) that a hold remains valid. Resellers must confirm the booking within this window; otherwise, the hold will automatically expire and the inventory will be released.
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
maxTravelers	int64	The maximum number of travelers (inclusive) allowed within a single Booking or Hold item. Requests exceeding this limit must be split into separate items or bookings.
minTravelers	int64	The minimum number of travelers (inclusive) required for a single Booking or Hold item. The request will be rejected if the guest count is below this threshold.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
hours	array[object]	The operational or opening hours for the experience. This defines the physical operating window of the venue and is distinct from real-time booking availability or capacity data.
dates	array[string]	Specific dates to which this rule applies. Use this for holiday-specific hours or scheduled closures.
daysOfWeek	array[integer]	Applicable days of the week. 1 is Monday, 7 is Sunday. If empty, the rule is assumed to apply only to the provided `dates`.
times	array[object]	The specific open and close time intervals for this rule.
close	string	Close time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
open	string	Open time in UTC, 24-hour time, with 'HH:mm' format pattern: `^([01]?[0-9]\|2[0-3]):[0-5][0-9]$`
timezone	string	The IANA timezone string (e.g., 'America/New_York'). If empty, open and close times are interpreted as UTC.
valid	object	The date and time window during which this Rate is active and available for booking.
from	date-time	The valid starting time (ISO 8601) of the validity period. The Rate is not active or bookable before this time.
until	date-time	The valid ending time (ISO 8601) of the validity period. The Rate expires and ceases to be bookable after this time.
prices	array[object]	A list of pricing configurations for this Rate. This defines the cost structure and any applicable Traveler Type distinctions.
id	uuid	Unique identifier for this Rate price
includedTaxes	array[object]	Breakdown of taxes included in the price dedicated to government taxes and fees.
currency	string	The currency code (ISO 4217 format) in which the tax amount is expressed (e.g., "USD", "EUR"). The currency must match the currency used for the item's price (original, net or retails). (required from Supplier) pattern: `^[A-Za-z]{3}$`
id	string	A unique identifier for the tax or fee. Strongly recommended for internal reference and integration purposes. (not required to be a UUID).
name	string	Human-readable title of the included taxes entry. A short, descriptive name for the tax being applied (e.g., "VAT", "City Tax"). The name should be unique. If no tax id is provided, the system will use the combination of name and currency to identify uniqueness. (required from Supplier)
original	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the original price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
net	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the net price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
retail	int64	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. This field represents the amount of tax or fee applied to the retail price. At least one of original, net, or retail price fields must be present (conditionally required from Supplier).
labels	array[string]	A list of filterable tags assigned to this price. Used in ChannelBindings (priceTags) to filter prices available by channel.
name	string	Human-readable name for the pricing.
net	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
original	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
retail	object	The value represents the smallest denomination of the currency and must be provided as a whole number. The relationship between the major unit and the minor unit varies by currency. Amounts must always be interpreted according to the ISO 4217 minor unit of the provided currency. `original`: The original price before any discounts are applied. Used to display a strike-through price in the UI. `net`: The wholesale amount owed to the Supplier by the Reseller. This is the settlement price for this pricing tier `retail`: The recommended selling price for the guest, inclusive of any applied discounts. This is the final price the guest pays.
amount	int64	The value in the minor unit of the currency (e.g., cents). For example, $1.00 is represented as 100.
currency	string	The three-letter ISO 4217 currency code (e.g., USD, EUR, GBP). pattern: `^[a-zA-Z]{3}$`
status	string	Determines if bound channels can list this price. Only 'ACTIVE' prices should be sold. Enum: `ACTIVE`,`INACTIVE`
travelerType	object	Defines the eligibility requirements and classification for a traveler. Includes age ranges, modifiers, and display information.
ageBand	string	The primary age-based category for the traveler. Enum: `ADULT`,`ANY`,`CHILD`,`INFANT`,`SENIOR`,`STUDENT`,`UNKNOWN`,`YOUTH`
extensions	object	Extended data of the travelerType. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: maxWeight: 85kg
maxAge	int32	The maximum age (inclusive) allowed for this traveler type.
minAge	int32	The minimum age (inclusive) required for this traveler type.
modifier	string	Additional qualification required for this price. Defaults to 'NONE' unless specific residency or status (e.g., MILITARY) is required. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
name	string	Name of the traveler type, e.g. Diver, Observer, Adult, Military
title	string	Customer-facing title for specific unit/traveler.
description	string	Structured description of the age, membership or role of the traveler this price is intended for.
constraints	array[object]
type	string	The category of the restriction. Enum: `MIN_AGE`,`MAX_AGE`,`MIN_WEIGHT`,`MAX_WEIGHT`,`MIN_HEIGHT`,`MAX_HEIGHT`,`REQUIRED_DOCUMENTS`,`OTHER`
min	number	The minimum value of this constraint.
max	number	The maximum value of this constraint.
unitId	string	Unique identifier for RatePrice which is Supplier specific e.g. Supplier's SKU code
extensions	object	Extended data for the rate price. Container for partner-specific data that is not otherwise represented in the core schema. Extensions may be used to exchange required operational or commercial information.
locations	array[object]
name	string	Technical or internal name of the location.
title	string	Customer-facing name of the location.
description	string	Informational description of the site.
address	object	A structured physical address for a venue, pickup point, or Supplier headquarters.
countryCode	string	ISO 3366-1 alpha-3 format pattern: `^[A-Za-z]{3}$`
googlePlaceId	string	DEPRECATED. Use the `references` array instead for platform-specific location IDs.
locality	string	Locality is usually the city or town name.
postalCode	string	The postal or ZIP code.
region	string	Region is usually the state, province, or territory.
streetAddress	string	Primary address line (street name and number).
longLat	object	Geographic coordinates for mapping and proximity searches.
latitude	number	Latitude in decimal degrees.
longitude	number	Longitude in decimal degrees.
website	string	URL for the location's official website or info page.
notes	string	Essential arrival instructions or guide tips.
type	string	The operational role of this location. Enum: `PRIMARY`,`OTHER`,`START`,`END`,`VISITED`,`ITINERARY_ITEM`,`POINT_OF_INTEREST`,`ADMISSION_INCLUDED`,`REDEMPTION`,`MEETING_POINT`
order	integer	The sequence of this location in the itinerary (starts at 1).
references	array[object]
platform	string	The external mapping or discovery service providing the reference ID. Enum: `GOOGLE_PLACE_ID`,`APPLE_PLACE_ID`,`TRIPADVISOR_LOCATION_ID`,`YELP_PLACE_ID`,`FACEBOOK_PLACE_ID`,`FOURSQUARE_PLACE_ID`,`BAIDU_PLACE_ID`,`AMAP_PLACE_ID`,`OTHER`
id	string	The unique identifier for the location on the specified platform. Example: 'ChIJN1t_tDeuEmsRUsoyG83frY4' for a Google Place ID.
name	string	The name of the location as registered on the external platform.
url	string	The direct URL to the location's page on the platform.
bookingQuestions	array[object]	An array of questions that can be asked during the booking flow. Visible when the `bookableQuestions` query parameter is set to `true`.
id	string
type	string	Describes the format of the answer expected by this question. - `text`, `email` and `phone` are all basic text types. - `integer` and `decimal` are numeric. - `boolean` is true/false. - `choice`, `multiple_choice` and `other` ask the user to select from a list of options. - `date` expects a date string, in the format `YYYY-MM-DD`. `time` expects a 24-hour hour and minute `HH:mm`. `datetime` expects a full ISO 8601 datetime stamp, `YYYY-MM-DDTHH:mm:ssZ`. Enum: `text`,`email`,`phone`,`integer`,`decimal`,`boolean`,`choice`,`multiple_choice`,`other`,`date`,`time`,`datetime`
text	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
required	boolean
pii	boolean
scope	string	A scope of `booking` is applied once for the whole group. A scope of `guest` is repeated for every guest. Enum: `booking`,`guest`
phase	string	Indicates at which phase of the booking flow an answer is collected. Enum: `hold`,`booking`
options	array[object]	Only populated if type is one of `"choice"` or `"multichoice"`.
label	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
constraints	array[object]
type	string	Enum: `height_cm`,`height_m`,`height_in`,`height_ft`,`weight_kg`,`weight_lb`,`string_length`,`numeric_range`,`selection_count`,`regex`,`purchase_limits`,`per_booking_purchase_limit`,`per_guest_purchase_limit`,`per_product_purchase_limit`,`per_day_purchase_limit`
min	number
max	number
message	array[object]	A collection of localized text entries representing the same content in multiple languages or formats.
text	string	The localized text value.
locale	string	Language and region identifier. MUST be a valid BCP 47 language tag.
format	string	Format of the text content. Enum: `plain`,`html`,`markdown`
pattern	string
dependency	object
questionId	string
answer	string
rateId	uuid	ID of the Rate. This field can optionally be provided on create. If a valid UUID is provided on create, it will be saved as the object's ID. Otherwise, the object will receive a generated ID.
startTime	date-time	The scheduled start date and time for the experience. Must align with a valid availability slot for the selected Rate.
status	string	The current lifecycle state of the booking item. `OPEN`: Active and valid for travel. `REDEEMED`: Guest has checked in or ticket was scanned. `CANCELLED`: Item is voided but record remains. `REFUNDED`: Item is voided and funds returned. `EXPIRED`: Validity window passed without redemption or confirmation. `DELETED`: Removed from a hold before finalization. `UNKNOWN`: State is undefined or out of sync. Enum: `CANCELLED`,`DELETED`,`EXPIRED`,`OPEN`,`REDEEMED`,`REFUNDED`,`UNKNOWN`
supplierId	uuid	The unique identifier of the Supplier that owns and operates this Product. This ID matches the id field of the parent Supplier entity and is used to maintain the relational link between the Supplier's organization and their inventory.
ext	object	Extended data for the booking item. Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: childSeat: 'No'
traveler	object	Individual participant details for the booking. These details are used for manifests, eligibility verification, and on-site identification.
firstName	string	First name of the individual traveler.
lastName	string	Last name of the individual traveler.
email	string	Individual email address, if different from the lead customer.
age	int32	Actual age of the traveler in years.
country	string	This MUST be a valid ISO 3166-1 alpha-2 or alpha-3 country code of the customer (e.g., USA, GBR, CAN). pattern: `^[A-Za-z]{3}$`
gender	string	Gender of the traveler. Enum: `FEMALE`,`MALE`
isLead	boolean	Indicates if this is the primary traveler for the item. Each Booking Item must have exactly one lead traveler.
lang	string	Spoken language as an ISO 639-3 code (e.g., ENG, FRA, DEU). code' pattern: `^[A-Za-z]{3}$`
phone	string	Phone number of the lead customer. Please follow this style guide when formatting phone numbers: https://developers.google.com/style/phone-numbers pattern: `^\+\d[\d\s-]+$`
extensions	object	Supplemental data such as dietary requirements or accessibility needs. Extensions may be used to exchange required operational or commercial information. example: specialRequest: Wheelchair accessibility
*	string
type	string	Matches the 'ageBand' from the RatePrice (e.g., ADULT, CHILD). Used for price validation.
answers	array[object]
question_id	string
partnerId	string	A Partner ID can be used to store a unique key in a partner's system.
resellerBookingRef	string	Reseller reference ID for the booking, used by the Reseller API client to provide their own reference for the booking.
status	string	The overall status of the booking. `OPEN`: Confirmed and active. `PENDING`: Awaiting final processing. `OLCI_PENDING`: Awaiting online check-in. `FAILED`: Booking was not successful. `REDEEMED`: All items have been scanned. `CANCELLED`: Entire booking is voided. Enum: `CANCELLED`,`DELETED`,`FAILED`,`OPEN`,`PENDING`,`REDEEMED`,`UNKNOWN`
tickets	array[object]	Tickets for the booking. The reservation system is ultimately responsible for the number of tickets being returned, and the value each ticket is redeemable for. Tickets usually represent a single item or group of items, but this varies from system to system. Please contact the reservation system you are connecting to for additional details on how their response tickets are structured.
barcode	object	Contains the digital fulfillment data for a ticket. This information is used to generate the visual or textual voucher presented at the venue.
format	string	The technical format or symbology of the barcode. This dictates how the Reseller should render the barcode image or text on the guest's ticket. Enum: `UNKNOWN`,`QR_CODE`,`EAN13`,`CODE128`,`UPCA`,`TEXT`,`CODE39`,`URL`,`INTERLEAVED`
value	string	The actual data string encoded in the barcode. This is the unique identifier that the venue's scanner will read.
bookingItemIds	array[string]	One or more references to Booking Item IDs.
guests	array[object]	The number of guests for this ticket.
count	integer	Number of guests.
typeCode	string	This should contain the `Rate.Prices[].Traveler.AgeBand` from the Price referenced by the Booking Item that corresponds to this ticket. Enum: `INFANT`,`CHILD`,`YOUTH`,`ADULT`,`SENIOR`,`STUDENT`,`ANY`
typeModifier	string	This should contain the `Rate.Prices[].Traveler.Modifier` from the Price referenced by the Booking Item that corresponds to this ticket. Enum: `EU_CITIZEN`,`GROUP`,`MILITARY`,`NONE`
typeName	string	This should contain the `Rate.Prices[].Traveler.Name` from the Price referenced by the Booking Item that corresponds to this ticket.
leadTraveler	object	Individual participant details for the booking. These details are used for manifests, eligibility verification, and on-site identification.
firstName	string	First name of the individual traveler.
lastName	string	Last name of the individual traveler.
email	string	Individual email address, if different from the lead customer.
age	int32	Actual age of the traveler in years.
country	string	This MUST be a valid ISO 3166-1 alpha-2 or alpha-3 country code of the customer (e.g., USA, GBR, CAN). pattern: `^[A-Za-z]{3}$`
gender	string	Gender of the traveler. Enum: `FEMALE`,`MALE`
isLead	boolean	Indicates if this is the primary traveler for the item. Each Booking Item must have exactly one lead traveler.
lang	string	Spoken language as an ISO 639-3 code (e.g., ENG, FRA, DEU). code' pattern: `^[A-Za-z]{3}$`
phone	string	Phone number of the lead customer. Please follow this style guide when formatting phone numbers: https://developers.google.com/style/phone-numbers pattern: `^\+\d[\d\s-]+$`
extensions	object	Supplemental data such as dietary requirements or accessibility needs. Extensions may be used to exchange required operational or commercial information. example: specialRequest: Wheelchair accessibility
*	string
type	string	Matches the 'ageBand' from the RatePrice (e.g., ADULT, CHILD). Used for price validation.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.Extensions may be used to exchange required operational or commercial information. example: additionalTicketInfo: Carry Prints
status	string	Ticket status Enum: `CANCELLED`,`DELETED`,`EXPIRED`,`OPEN`,`REDEEMED`,`REFUNDED`,`UNKNOWN`
timeline	array[object]	Timeline of actions taken on the Booking.
timestamp	date-time
typeOf	string	Enum: `CANCELLED`,`DELETED`,`OPEN`,`PENDING`,`REDEEMED`,`RELEASED`,`TICKETS_ADDED`,`UNKNOWN`
version	int32	Internal version number
answers	array[object]
question_id	string
meta	object	Request meta data
reqId	string	Request ID for request tracking. An identifier unique to the request, which is passed from the Reseller through Travel Curious to the operator. If the Reseller does not provide a request ID, Travel Curious will generate an ID and return it to the Reseller.
data	object	A map of supplementary metadata. This may include non-breaking warnings, system-specific flags, or additional context regarding the response or error state.
*	string

401

Unauthorized

404

Not Found

503

The server is temporarily unavailable, either because the server is under maintenance, or overloaded (accepted too many requests in too short a time).

Response

Travel Curious Reseller API Reference (Beta) 1.3Proprietary

This API enables partners to:

🆕 What's New in v1.3

Authentication

Suppliers

Retrieve a list of Suppliers

Retrieve a single Supplier

Products

Retrieve a list of Products

Retrieve a single Product

Rates

Retrieve a list of Rates

Retrieve a single Rate

Availabilities

Retrieve a list of availabilities

Retrieve a single availability

Price Schedule

Fetches a price schedule.

Holds

Acquire a hold

Retrieve a hold

Release a hold

Bookings

Creates a new booking.

Cancel an existing booking.

Retrieve a single booking.

Travel Curious Reseller API Reference (Beta) 1.3 Proprietary