Re-order items
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/transactional-list/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51/items/sort';const options = { method: 'PATCH', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"items":[{"item":{"hotelIdentifier":"e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18","itemIdentifier":"8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29","itemType":"GUEST_ROOM"},"position":0}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/transactional-list/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51/items/sort \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data '{ "items": [ { "item": { "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "itemIdentifier": "8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29", "itemType": "GUEST_ROOM" }, "position": 0 } ] }'Applies a new display order to the items within an existing CURATED list.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Managing entity identifier that owns the list.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69List identifier.
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”The items and the 0-based position each should take
Request to apply a new display order to the items within a curated transactional list.
object
The items and the position each should take (0-based).
An item of a curated transactional list and the 0-based position it should take.
object
The item, as it is referenced on the list.
object
The hotel the item belongs to.
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18Master rate id (GUEST_ROOM), add-on id (ADD_ON), venue id (venue types) or the hotel id (HOTEL).
Example
8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29What kind of item.
Example
GUEST_ROOMExample
{ "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "itemIdentifier": "8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29", "itemType": "GUEST_ROOM"}0-based position the item should take.
Example
0Example
{ "item": { "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "itemIdentifier": "8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29", "itemType": "GUEST_ROOM" }, "position": 0}Example
{ "items": [ { "item": { "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "itemIdentifier": "8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29", "itemType": "GUEST_ROOM" }, "position": 0 } ]}Responses
Section titled “Responses”The list, with its items reordered.
Lightweight projection of a transactional list used in listings and event payloads, containing all display and configuration fields without audit metadata
object
Generate an animated GIF from multiple images instead of a static grid (requires at least 2 images)
Delay between animation frames in milliseconds; -1 disables animation
Datetime this record was first created
Saved-search filter criteria; present for SEARCH lists only
object
Filter on aggregate review score the hotel has
Supported OTA specification ARC code. See OTA geoname data
City filter
Continent filter
Country filter
Supported OTA specification PCT code. See OTA geoname data
Filter on number of stars the hotel has.
Regex expression filter matching on inventory name
Filter on inventory types
Filter on lifestyles
Supported OTA specification LOC code. See OTA geoname data
Name of dynamic list for when user want to persist it
Find hotels close to certain location
object
Control how you want the search results sorted. Options are:
- 1: Inventory name
- 2: Price: High to low
- 3: Price: Low to high
- 4: Commission: High to low
- 5: Commission: Low to high
- 6: Discount: High to low
- 7: Discount: Low to high
A literal, case-insensitive part of the property name, not a regular expression: The Siam matches The Siam Guest House.
Use this in conjunction with nearPoint. Control the distance from point we are searching for.
Supported OTA specification SEG code. See OTA geoname data
Filter on child-friendly hotels
Filter on direct inventory
Filter on eco-friendly hotels
Filter on pet-friendly hotels
Filter on hotel that has had a certain amount of bookings
Customization configuration identifier
Localized title and description of the list (at least one entry in English required)
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Use as title or short text description
Unique identifier for this record.
Embedded inventory items, in display order; populated for CURATED lists only, empty otherwise
One inventory item embedded on a curated transactional list; its position in the items array is its display order.
object
The snapshotted sales channel inventory item
object
Whether this is commissionable or not
Whether this inventory is enabled or not
Main image of inventory
object
Media angle
Whether image has attribution properties
object
Name of contributor
URL to contributor
Supported OTA specification PIC code. See OTA geoname data
Localized media captions to give user some context about where this media was taken.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Use as title or short text description
Media height in pixels.
Use this identifier to communicate with Cloudinary.
True if media width is greater or equal to height
Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.
Document identifier
Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.
Sort allows you to control how you want to sort this record in a list of media records.
Currently ONLY using Cloudinary to store all image / video assets.
Whether Cloudinary media is a VIDEO or IMAGE.
Media width in pixels.
Inventory type identifier
Name of inventory as traveler is seeing it
Inventory type
Location
object
Best price of the room type or facility ancillary in platform currency
object
Monetary amount value
ISO 4217 currency code
Best price of the room type or facility ancillary
object
Monetary amount value
ISO 4217 currency code
Level of expensiveness.
What this entry sells: the item type, its identifier and its hotel. It addresses the item on the list.
object
The hotel the item belongs to.
Master rate id (GUEST_ROOM), add-on id (ADD_ON), venue id (venue types) or the hotel id (HOTEL).
What kind of item.
Parent sales channel
object
A way to blacklist a specific channel a property doesn’t want to send blocking to.
System override by supplier to disable channel. E.g. Platform disables supplier.
Amount of sales commission earned through this channel and all its children [unless configured at the child level].
Datetime this record was first created
Flag the supplier can use to enable / disable this channel
Unique identifier for this record.
Datetime this record was last updated
A specific identifier for the company / corporation / travel agency that is retrieving the rates
Name of the owner / affiliate. Hotel booking customization when it’s the booking customization.
Percent discount on this channel and all its children [unless configured at the child level].
Promotion bundles for this channel
A lightweight projection of a promotion bundle containing the full set of qualifying conditions and metadata.
object
Simplified localized description containing text content and its language code.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Datetime this record was first created
Optional bundle-level descriptions. When populated, these replace the aggregated item descriptions in offerDetails.
Simplified localized description containing text content and its language code.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Simplified localized description containing text content and its language code.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Whether this promotion ancillary is enabled or not.
Hotel identifier.
Unique identifier for this record.
Promotions that go together to make up this ancillary.
object
Restrict promotion to users who want to book in advance.
Restrict promotion to specific days of the week the guest is arriving.
Restrict promotion to specific days of the week the promotion is available.
A date range during which a promotion is not available (blackout period).
object
Start date when the promotion is not available (inclusive).
End date when the promotion is not available (inclusive).
Qualifier that restricts a promotion to guests whose IP geolocation resolves to a specific city.
object
City details (obtained via geonames) to restrict the promotion by guest location.
object
City name
Continent code
Continent name
Country ISO code
Country name
GeoNameLightweight identifiers taken from https://geonames.org.
Locale code
Sub-division 1 code
Sub-division 1 name
Sub-division 2 code
Sub-division 2 name
Timezone
Qualifier that restricts a promotion to guests whose IP geolocation resolves to a specific continent.
object
Two-letter continent code (e.g. NA, EU, AS)
Qualifier that restricts a promotion to guests whose IP geolocation resolves to a specific country.
object
Country (obtained via geonames) to restrict the promotion by guest location.
object
Continent code (two-letter ISO)
Continent name
Country ISO 3166-1 alpha-2 code
Country name
GeoNames identifier
Datetime this record was first created
Restrict promotion to specific days of the week the guest is departing.
Simplified localized description containing text content and its language code.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Whether this promotion is enabled or not.
Qualifier that restricts a promotion to guests within a circular geographic area defined by a center point and radius.
object
Latitude of the center point for the geo-location radius check.
Longitude of the center point for the geo-location radius check.
Radius in kilometers around the center point within which the guest must be located.
Unique identifier of the property this promotion belongs to.
Unique identifier for this record.
Qualifier that restricts a promotion to guests whose IP address falls within a specified IPv4 range.
object
Ending IP address of the range (inclusive).
Starting IP address of the range (inclusive).
Restrict promotion to users who want to book a room close to the date.
Datetime this record was last updated
Restrict promotion to users who want to stay a certain number of days.
The discount or premium amount and its type (fixed or percentage).
Internal name of promotion.
Restrict promotion to either prepaid / non-prepaid rates.
This determines whether this discount should be applied per night, per stay or per person - per night
Qualifier that restricts a promotion to guests who enter a specific promotional code at checkout.
object
Promo code that guests must enter to access this promotion.
Restrict promotion to either refundable / non-refundable rates.
Restrict promotion to specific days of the week the guest has to stay.
Restrict promotion by restricting to how many rooms the user wants.
Qualifier that restricts a promotion to bookings made within a specific date window.
object
Promotion is available when the booking is made on or after this date (inclusive).
Promotion is available when the booking is made on or before this date (inclusive).
Rate qualifier that restricts a promotion to guests whose stay falls within a specific date range.
object
Promotion applies when guest’s stay starts on or after this date (inclusive).
Promotion applies when guest’s stay starts on or before this date (inclusive).
Qualifier that restricts a promotion to guests whose system timezone matches the specified IANA timezone name.
object
IANA timezone name of the booker’s location (e.g. Asia/Bangkok).
Set whether you want the price to go up or down when the rules of this promotion have been satisfied.
Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.
Datetime this record was last updated
Optional: override the combined discount of all bundle items with a single fixed or percentage amount.
Internal name of promotion ancillary.
Determines whether this discount should be applied per night, per stay or per person - per night; Required if amount override is not null
Required if manual override modifier is not null
Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.
Promotions for this channel
A lightweight projection of a special rate (promotion) containing all qualifying conditions and metadata.
object
Restrict promotion to users who want to book in advance.
Restrict promotion to specific days of the week the guest is arriving.
Restrict promotion to specific days of the week the promotion is available.
A date range during which a promotion is not available (blackout period).
object
Start date when the promotion is not available (inclusive).
End date when the promotion is not available (inclusive).
Qualifier that restricts a promotion to guests whose IP geolocation resolves to a specific city.
object
City details (obtained via geonames) to restrict the promotion by guest location.
object
City name
Continent code
Continent name
Country ISO code
Country name
GeoNameLightweight identifiers taken from https://geonames.org.
Locale code
Sub-division 1 code
Sub-division 1 name
Sub-division 2 code
Sub-division 2 name
Timezone
Qualifier that restricts a promotion to guests whose IP geolocation resolves to a specific continent.
object
Two-letter continent code (e.g. NA, EU, AS)
Qualifier that restricts a promotion to guests whose IP geolocation resolves to a specific country.
object
Country (obtained via geonames) to restrict the promotion by guest location.
object
Continent code (two-letter ISO)
Continent name
Country ISO 3166-1 alpha-2 code
Country name
GeoNames identifier
Datetime this record was first created
Restrict promotion to specific days of the week the guest is departing.
Simplified localized description containing text content and its language code.
object
Whether it was user or system generated.
Longer text description
Indicate which language this description is written in.
The md5 hash of the name, description and language.
Whether this promotion is enabled or not.
Qualifier that restricts a promotion to guests within a circular geographic area defined by a center point and radius.
object
Latitude of the center point for the geo-location radius check.
Longitude of the center point for the geo-location radius check.
Radius in kilometers around the center point within which the guest must be located.
Unique identifier of the property this promotion belongs to.
Unique identifier for this record.
Qualifier that restricts a promotion to guests whose IP address falls within a specified IPv4 range.
object
Ending IP address of the range (inclusive).
Starting IP address of the range (inclusive).
Restrict promotion to users who want to book a room close to the date.
Datetime this record was last updated
Restrict promotion to users who want to stay a certain number of days.
The discount or premium amount and its type (fixed or percentage).
Internal name of promotion.
Restrict promotion to either prepaid / non-prepaid rates.
This determines whether this discount should be applied per night, per stay or per person - per night
Qualifier that restricts a promotion to guests who enter a specific promotional code at checkout.
object
Promo code that guests must enter to access this promotion.
Restrict promotion to either refundable / non-refundable rates.
Restrict promotion to specific days of the week the guest has to stay.
Restrict promotion by restricting to how many rooms the user wants.
Qualifier that restricts a promotion to bookings made within a specific date window.
object
Promotion is available when the booking is made on or after this date (inclusive).
Promotion is available when the booking is made on or before this date (inclusive).
Rate qualifier that restricts a promotion to guests whose stay falls within a specific date range.
object
Promotion applies when guest’s stay starts on or after this date (inclusive).
Promotion applies when guest’s stay starts on or before this date (inclusive).
Qualifier that restricts a promotion to guests whose system timezone matches the specified IANA timezone name.
object
IANA timezone name of the booker’s location (e.g. Asia/Bangkok).
Set whether you want the price to go up or down when the rules of this promotion have been satisfied.
Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.
Whether the sales channel is a self-acquiring entity.
What type of segment of channel is this.
Channel is owned by this supplier identifier.
Name of property / supplier that owns this channel
Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.
Availability status of this item; defaults to ACTIVE
Keywords and metadata tags for SEO and filtering
Distinguishes the auto-created favorites list from any other curated list; present for CURATED lists only
Datetime this record was last updated
The ranked destination this list displays inventory from; present for RANKED lists only
object
Name of the closest city where this lookup entry is located
ISO 3166-1 alpha-2 country code
Country name where this lookup entry is located
Datetime this record was first created
Unique identifier for this record.
Language code for the lookup name (ISO 639-1 format)
Datetime this record was last updated
Geo-location
object
Lowercase version of the name, used for regex-based search operations. Extranet surfaces only.
Human-readable name of the lookup entry
Whether this is the primary/original lookup entry for this resource (true) or a variant like an alternate language or name (false). Extranet surfaces only.
Identifier of the owner (supplier) that created or manages this lookup entry. Extranet surfaces only — not serialized on public or partner endpoints.
Name of the owner (supplier) that created this lookup entry
Type of owner that created this lookup (TRAVELIKO for platform-managed entries, HOTEL for supplier-created entries). Extranet surfaces only.
Platform-specific sort order (lower values sort first: CITY=1, ISLAND=2, HOTEL=3, others vary). Extranet surfaces only.
State or province where this lookup entry is located
County or district where this lookup entry is located
Type of lookup (CITY, HOTEL, ACTIVITY, SPA, RESTAURANT, ATTRACTION, ISLAND, COUNTRY, PLACE, MEETING_ROOM)
Unique identifier for the lookup type resource (e.g., hotel ID, city geoname ID)
URL-friendly slug that uniquely identifies this lookup within its type and location
Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.
Descriptive name of this list for seller use only
Managing entity (account owner) identifier
Badge type and sort order for display on web component (MEMBER, BEST_VALUE, TOP_RATED, etc.)
What this list is backed by: a curated set of embedded items, a saved search, or a ranked destination
Current status of the list (ACTIVE, INACTIVE, ARCHIVED)
Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.
Example
{ "animate": false, "animateDelay": 500, "createdDate": "2026-01-14T09:30:00", "criteria": { "aggregateReviewRating": 8, "architecturalStyles": 7, "cities": [ "1609350" ], "continents": [ "AS" ], "countries": [ "1605651" ], "hotelCategories": 1, "hotelStars": 5, "inventoryName": "Deluxe Suite", "inventoryTypes": [ "GUEST_ROOM" ], "locationCategories": 1701, "name": "Bangkok Luxury Hotels", "primaryOrderBy": "4", "propertyName": "The Siam", "radiusInMeters": 5000, "segmentCategories": 7, "showChildFriendly": false, "showDirectOnly": false, "showEcoFriendly": false, "showPetFriendly": false, "showPopular": false }, "customizationIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "descriptions": [ { "creator": "USER", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82", "name": "Deluxe River View Suite" } ], "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "items": [ { "item": { "commissionable": true, "enabled": true, "image": "https://res.cloudinary.com/wink/image/upload/v1/property/the-siam-residences.jpg", "inventoryIdentifier": "8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29", "inventoryNameInEnglish": "The Siam Residences, Bangkok", "inventoryType": "GUEST_ROOM", "location": { "coordinates": [ 100.5581533, 13.7370197 ], "type": "POINT" }, "lowestDisplayPrice": 450, "lowestPrice": 450, "pricePoint": "THREE", "reference": { "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "itemIdentifier": "8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29", "itemType": "GUEST_ROOM" }, "salesChannel": { "blacklisted": false, "channelDisabled": false, "commission": 0.2, "createdDate": "2026-01-14T09:30:00", "enabled": true, "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "lastUpdate": "2026-02-03T16:45:12", "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "ownerName": "The Siam Residences", "percentDiscount": 0.15, "rateModifierBundles": [ { "aggregatedItemDescriptions": [ { "creator": "USER", "description": "This is a longer description in the specified language.", "language": "en", "md5ContentHash": "d41d8cd98f00b204e9800998ecf8427e" } ], "createdDate": "2026-01-14T09:30:00", "descriptions": [ { "creator": "USER", "description": "This is a longer description in the specified language.", "language": "en", "md5ContentHash": "d41d8cd98f00b204e9800998ecf8427e" } ], "effectiveDescriptions": [ { "creator": "USER", "description": "This is a longer description in the specified language.", "language": "en", "md5ContentHash": "d41d8cd98f00b204e9800998ecf8427e" } ], "enabled": true, "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "items": [ { "addOnIdentifiers": [ "880e8400-e29b-41d4-a716-446655440333" ], "blackoutDates": [ { "effectiveDate": "2026-04-13", "expireDate": "2026-04-15" } ], "cityRateQualifiers": [ { "city": { "countryCode": "TH", "geoNameId": "1609350", "latitude": 13.7563, "longitude": 100.5018, "name": "Bangkok" } } ], "continentRateQualifiers": [ { "continent": "NA" } ], "countryRateQualifiers": [ { "country": { "continentCode": "AS", "geoNameId": "1609350", "isoAlpha2": "TH", "isoAlpha3": "THA", "name": "Thailand" } } ], "createdDate": "2026-01-14T09:30:00", "descriptions": [ { "creator": "USER", "description": "This is a longer description in the specified language.", "language": "en", "md5ContentHash": "d41d8cd98f00b204e9800998ecf8427e" } ], "enabled": true, "geoLocationRateQualifiers": [ { "latitude": 13.7563, "longitude": 100.5018, "radiusInKilometers": 50 } ], "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "ipRangeRateQualifiers": [ { "endIPRange": "192.168.1.255", "startIPRange": "192.168.1.0" } ], "lastUpdate": "2026-02-03T16:45:12", "masterRateIdentifiers": [ "770e8400-e29b-41d4-a716-446655440222" ], "name": "Early bird", "pricingType": "PER_PERSON_PER_NIGHT", "promotionRateQualifiers": [ { "promotion": "EARLYBIRD2026" } ], "ratePlanIdentifiers": [ "990e8400-e29b-41d4-a716-446655440444" ], "sellDateRateQualifiers": [ { "effectiveDate": "2026-05-01", "expireDate": "2026-08-31" } ], "stayDateRateQualifiers": [ { "effectiveDate": "2026-06-01", "expireDate": "2026-08-31" } ], "timezoneRateQualifiers": [ { "timezone": "Asia/Bangkok" } ], "type": "DISCOUNT", "version": 3 } ], "lastUpdate": "2026-02-03T16:45:12", "name": "Early bird - Long Term", "pricingType": "PER_NIGHT", "type": "DISCOUNT", "version": 3 } ], "rateModifiers": [ { "addOnIdentifiers": [ "880e8400-e29b-41d4-a716-446655440333" ], "blackoutDates": [ { "effectiveDate": "2026-04-13", "expireDate": "2026-04-15" } ], "cityRateQualifiers": [ { "city": { "countryCode": "TH", "geoNameId": "1609350", "latitude": 13.7563, "longitude": 100.5018, "name": "Bangkok" } } ], "continentRateQualifiers": [ { "continent": "NA" } ], "countryRateQualifiers": [ { "country": { "continentCode": "AS", "geoNameId": "1609350", "isoAlpha2": "TH", "isoAlpha3": "THA", "name": "Thailand" } } ], "createdDate": "2026-01-14T09:30:00", "descriptions": [ { "creator": "USER", "description": "This is a longer description in the specified language.", "language": "en", "md5ContentHash": "d41d8cd98f00b204e9800998ecf8427e" } ], "enabled": true, "geoLocationRateQualifiers": [ { "latitude": 13.7563, "longitude": 100.5018, "radiusInKilometers": 50 } ], "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "ipRangeRateQualifiers": [ { "endIPRange": "192.168.1.255", "startIPRange": "192.168.1.0" } ], "lastUpdate": "2026-02-03T16:45:12", "masterRateIdentifiers": [ "770e8400-e29b-41d4-a716-446655440222" ], "name": "Early bird", "pricingType": "PER_PERSON_PER_NIGHT", "promotionRateQualifiers": [ { "promotion": "EARLYBIRD2026" } ], "ratePlanIdentifiers": [ "990e8400-e29b-41d4-a716-446655440444" ], "sellDateRateQualifiers": [ { "effectiveDate": "2026-05-01", "expireDate": "2026-08-31" } ], "stayDateRateQualifiers": [ { "effectiveDate": "2026-06-01", "expireDate": "2026-08-31" } ], "timezoneRateQualifiers": [ { "timezone": "Asia/Bangkok" } ], "type": "DISCOUNT", "version": 3 } ], "selfAcquires": false, "subType": "DIRECT", "supplierIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "supplierName": "The Siam Residences, Bangkok", "version": 3 } }, "status": "ACTIVE" } ], "keywords": [ "bangkok", "luxury" ], "kind": "NORMAL", "lastUpdate": "2026-02-03T16:45:12", "lookup": { "cityName": "Bangkok", "countryCode": "TH", "countryName": "Thailand", "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "languageCode": "en", "location": { "coordinates": [ 100.5581533, 13.7370197 ], "type": "Point" }, "name": "The Siam Residences", "ownerName": "The Siam Residences", "subCountryName": "Bangkok", "subSubCountryName": "Khlong San District", "type": "HOTEL", "typeIdentifier": "a1f3c9d2-7e4b-4a0c-8d5e-2b9f1a6c3e78", "urlName": "the-siam-residences-bangkok-thailand" }, "name": "Luxury Bangkok Properties", "sellerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "sort": "MEMBER", "source": "CURATED", "status": "ACTIVE", "version": 3}Bad Request — missing or invalid request parameter or body
object
object
Example generated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Unauthorized — authentication is required or the session has expired
object
object
Example generated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Forbidden — authenticated but lacking the required permission or scope
object
object
Example generated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Not Found — the requested resource does not exist
object
object
Example generated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example generated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example generated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Unsupported Media Type — use application/json
object
object
Example generated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Internal Server Error — an unexpected failure occurred on the server
object
object
Example generated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Service Unavailable — a downstream dependency is unreachable
object
object
Example generated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}