Travel Curious Reseller API Reference 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.
Add-ons: Suppliers can now configure optional (and occasionally mandatory) items to be purchased alongside a base booking. Attached at the Product, Rate, or Traveler level, this capability allows Resellers to seamlessly surface consumable items, equipment rentals, and experience upgrades directly in the checkout flow.
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

Endpoints

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 'Accept: application/json' \ --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
meta2 fields	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
suppliers15 fields	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.
ext	object	DEPRECATED. Use `extensions` instead Deprecated
businessType	array[string]	DEPRECATED. pattern: `^\w+$` Deprecated
contacts4 fields	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.
mainLocation10 fields	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.
address6 fields	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).
references4 fields	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.
otherLocations10 fields	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.
address6 fields	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).
references4 fields	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.
hours5 fields	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.
travelerTypes11 fields	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
ext	object	deprecated - use extensions instead Deprecated
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.
constraints5 fields	array[object]
type	string	The category of the restriction. 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	The minimum value of this constraint.
max	number	The maximum value of this constraint.
message3 fields	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	A regular expression pattern that the value must match.
addOns13 fields	array[object]	A list of available AddOn definitions.
id	string	Unique identifier for this AddOn definition.
internalName	string	A system or supplier-facing internal name for the add-on.
title	string	The customer-facing title or display name of the add-on.
description	string	A short, human-readable description of what the add-on provides.
reference	string	The supplier's external reference or SKU for this add-on.
scope	string	Indicates whether this add-on applies per guest, per booking, or globally. Enum: `product`,`booking`,`guest`,`day`
constraints5 fields	array[object]	Validation rules and limits (e.g., min/max selections, height/weight requirements).
type	string	The category of the restriction. 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	The minimum value of this constraint.
max	number	The maximum value of this constraint.
message3 fields	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	A regular expression pattern that the value must match.
deliveryFormats	array[string]	Technical formats of the barcode or identifier issued for this add-on upon fulfillment. Enum: `QR_CODE`,`EAN13`,`CODE128`,`UPCA`,`TEXT`,`CODE39`,`URL`,`INTERLEAVED`
deliveryMethods	array[string]	Defines how fulfillment identifiers are distributed (e.g., TICKET or VOUCHER). Enum: `TICKET`,`VOUCHER`
redemptionMethod	string	The required customer presentation method for redeeming the add-on. Enum: `MANIFEST`,`DIGITAL`,`PRINT`
policy5 fields	object	Specific cancellation and hold policies applied to this add-on.
cancellable	boolean	Indicates whether Bookings can be cancelled after confirmation
refundable	boolean	Indicates whether Bookings can be refunded after confirmation
cutOffTime	int64	The minimum amount of time (in minutes) between the current time and the start time of a new hold
holdablePeriod	int64	The maximum interval (in seconds) between a hold's creation & expiration time
cancelPolicy	string	Text that defines the cancellation policy
content14 fields	object	Rich, localized marketing content, media, and features for this add-on.
id	string	Unique identifier for this content object. Used to reference and manage content independently of the parent entity.
name3 fields	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`
title3 fields	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`
subtitle3 fields	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`
description3 fields	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`
shortDescription3 fields	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`
categories3 fields	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`
duration4 fields	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`
description3 fields	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`
faqs2 fields	array[object]
question3 fields	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`
answer3 fields	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`
features2 fields	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`
description3 fields	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`
media8 fields	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`
title3 fields	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`
caption3 fields	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`
copyright3 fields	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`
credits3 fields	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`
metadata3 fields	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`
ratings4 fields	array[object]
source3 fields	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`
average3 fields	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
reviews7 fields	array[object]
reviewerName3 fields	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`
title3 fields	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`
content3 fields	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`
source3 fields	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`
rating3 fields	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.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.

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 'Accept: application/json' \ --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
meta2 fields	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
supplier16 fields	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.
ext	object	DEPRECATED. Use `extensions` instead Deprecated
businessType	array[string]	DEPRECATED. pattern: `^\w+$` Deprecated
contacts4 fields	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.
mainLocation10 fields	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.
address6 fields	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).
references4 fields	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.
otherLocations10 fields	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.
address6 fields	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).
references4 fields	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.
hours5 fields	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.
travelerTypes11 fields	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
ext	object	deprecated - use extensions instead Deprecated
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.
constraints5 fields	array[object]
type	string	The category of the restriction. 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	The minimum value of this constraint.
max	number	The maximum value of this constraint.
message3 fields	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	A regular expression pattern that the value must match.
addOns13 fields	array[object]	A list of available AddOn definitions.
id	string	Unique identifier for this AddOn definition.
internalName	string	A system or supplier-facing internal name for the add-on.
title	string	The customer-facing title or display name of the add-on.
description	string	A short, human-readable description of what the add-on provides.
reference	string	The supplier's external reference or SKU for this add-on.
scope	string	Indicates whether this add-on applies per guest, per booking, or globally. Enum: `product`,`booking`,`guest`,`day`
constraints5 fields	array[object]	Validation rules and limits (e.g., min/max selections, height/weight requirements).
type	string	The category of the restriction. 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	The minimum value of this constraint.
max	number	The maximum value of this constraint.
message3 fields	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	A regular expression pattern that the value must match.
deliveryFormats	array[string]	Technical formats of the barcode or identifier issued for this add-on upon fulfillment. Enum: `QR_CODE`,`EAN13`,`CODE128`,`UPCA`,`TEXT`,`CODE39`,`URL`,`INTERLEAVED`
deliveryMethods	array[string]	Defines how fulfillment identifiers are distributed (e.g., TICKET or VOUCHER). Enum: `TICKET`,`VOUCHER`
redemptionMethod	string	The required customer presentation method for redeeming the add-on. Enum: `MANIFEST`,`DIGITAL`,`PRINT`
policy5 fields	object	Specific cancellation and hold policies applied to this add-on.
cancellable	boolean	Indicates whether Bookings can be cancelled after confirmation
refundable	boolean	Indicates whether Bookings can be refunded after confirmation
cutOffTime	int64	The minimum amount of time (in minutes) between the current time and the start time of a new hold
holdablePeriod	int64	The maximum interval (in seconds) between a hold's creation & expiration time
cancelPolicy	string	Text that defines the cancellation policy
content14 fields	object	Rich, localized marketing content, media, and features for this add-on.
id	string	Unique identifier for this content object. Used to reference and manage content independently of the parent entity.
name3 fields	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`
title3 fields	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`
subtitle3 fields	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`
description3 fields	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`
shortDescription3 fields	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`
categories3 fields	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`
duration4 fields	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`
description3 fields	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`
faqs2 fields	array[object]
question3 fields	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`
answer3 fields	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`
features2 fields	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`
description3 fields	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`
media8 fields	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`
title3 fields	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`
caption3 fields	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`
copyright3 fields	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`
credits3 fields	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`
metadata3 fields	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`
ratings4 fields	array[object]
source3 fields	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`
average3 fields	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
reviews7 fields	array[object]
reviewerName3 fields	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`
title3 fields	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`
content3 fields	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`
source3 fields	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`
rating3 fields	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.
extensions	object	Container for partner-specific data that is not otherwise represented in the core schema.
content14 fields	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.
name3 fields	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`
title3 fields	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`
subtitle3 fields	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`
description3 fields	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`
shortDescription3 fields	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`
categories3 fields	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`
duration4 fields	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`
description3 fields	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`
faqs2 fields	array[object]
question3 fields	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`
answer3 fields	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`
features2 fields	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`
description3 fields	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`
media8 fields	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`
title3 fields	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`
caption3 fields	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`
copyright3 fields	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`
credits3 fields	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`
metadata3 fields	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`
ratings4 fields	array[object]
source3 fields	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`
average3 fields	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
reviews7 fields	array[object]
reviewerName3 fields	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`
title3 fields	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`
content3 fields	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`
source3 fields	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`
rating3 fields	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": {...},
 "supplier": {...}
}
Copy

Products

Endpoints

GET

/suppliers/{supplier_id}/products

GET

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

Show

Rates

Endpoints

GET

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

GET

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

Show

Availabilities

Endpoints

GET

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

GET

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

Show

Price Schedule

Endpoints

GET

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

Show

Holds

Endpoints

Show

Bookings

Endpoints

POST

/bookings

PUT

/bookings/cancel/{booking_id}

GET

/bookings/{booking_id}

Show

Travel Curious Reseller API Reference 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

Rates

Availabilities

Price Schedule

Holds

Bookings

Travel Curious Reseller API Reference 1.3 Proprietary