By ID
const url = 'https://api.wink.travel/api/public/configuration/example';const options = { method: 'GET', headers: {'Wink-Version': '2.0', Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.wink.travel/api/public/configuration/example \ --header 'Authorization: Bearer <token>' \ --header 'Wink-Version: 2.0'Resolves the affiliate’s client configuration from a specific customization record identifier.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Query Parameters
Section titled “Query Parameters ”Header Parameters
Section titled “Header Parameters ”Responses
Section titled “ Responses ”OK
Resolved booking engine customization configuration exposed to client-side web components; merges affiliate overrides onto the base configuration
object
Unique customization configuration identifier
Engine configuration name
Whether to append text to the existing booking customization page title.
Managing entity identifier
Managing entity name.
Managing entity identifier of affiliate
Sales channel sub-type.
If you want to track analytics with Google Analytics using your GA4 Measurement ID.
If you want to track analytics and you have a GTM Container ID, enter it here.
If you want your users to see Google Maps in your hosted booking customization, go to Google Maps and create an API key for your site.
Control which currency your users see prices in initially.
Control which language your users see text in initially.
Customize booking confirmation emails by adding a custom logo to your configuration.
If you are self-hosting our booking customization, let us know where it is hosted. Note: This url needs to be secured with SSL.
Flag to indicate you are self-hosting our booking customization and not using our default booking customization url.
Choose how you want our web components to look and more closely match with your own site style.
object
Primary color
Secondary color
Success color
Danger color
Warning color
Info color
Light color
Dark color
Body color
Muted color
White color
You can control the initial itinerary date used to retrieve travel inventory prices. You can do it in one of two ways: 1. Dynamically set the date by indicating how long and how many days in advance (this field), of today’s date, you want to display prices for. 2. Set a fixed date to display prices for. Option 1 is the most shared. Option 2 is for when you want to create a new customization and apply it to a specific event that occurs on a specific date. If you don’t use either of these options, the itinerary will default to today’s date with one night stay. ONLY populate this field if you want to control the itinerary date. Also, leave startDate and endDate empty.
You can control the initial itinerary date used to retrieve travel inventory prices. You can do it in one of two ways: 1. Dynamically set the date by indicating how long (this field) and how many days in advance, of today’s date, you want to display prices for. 2. Set a fixed date to display prices for. Option 1 is the most shared. Option 2 is for when you want to create a new customization and apply it to a specific event that occurs on a specific date. If you don’t use either of these options, the itinerary will default to today’s date with one night stay. ONLY populate this field if you want to control the itinerary date. Also, leave startDate and endDate empty.
Set a fixed itinerary start date. ONLY populate this field if you want to fix the itinerary date. Also, leave numberOfAdvanceDays and numberOfStayDays empty.
Set a fixed itinerary end date ONLY populate this field if you want to fix the itinerary date. Also, leave numberOfAdvanceDays and numberOfStayDays empty.
Control how many adults / children will be staying and how many rooms. Defaults to: One room, two adults.
Room occupancy and guest composition for a single or multiple identical rooms
object
Number of adult guests in this room type
Child guests in this room, with age groups
Child guest with age and quantity in a room configuration
object
Count of children of this age group in the room
Age of each child in this group (years)
Number of identical rooms with this configuration
If true, we use numberOfAdvanceDays / numberOfStayDays properties - false, we use startDate / endDate
If you’ve received special promotional codes from suppliers to give to your audience, you can choose to bake these code directly into the price by entering them here.
Action to complete once a user clicks on the CTA button on inventory.
Show unavailable inventory card when inventory not currently for sale. Otherwise, it displays a normal card but without the price.
Whether to display rankings (lifestyle, eco score and reviews) on hotel landing page.
This feature flag controls whether to let a user move away from the hotel landing page using search.
Choose how you want our web component cards laid out.
Choose how you large you want our web component cards to be.
Tracking pixels to fire on key booking events.
Tracking pixel or web beacon configuration that fires on specified booking events for analytics and conversion tracking
object
Unique identifier for this tracking pixel
User-friendly name for this tracking pixel
Type of tracking pixel delivery mechanism
Tracking pixel provider
Consent category for GDPR/CCPA compliance
Whether this tracking pixel is currently active
Provider-specific pixel ID (e.g., Facebook Pixel ID, Google Ads Conversion ID)
Optional access token for providers that require authentication
Custom JavaScript code for CUSTOM provider type. Will be injected into the page.
Custom image URL for IMAGE type pixels. Will be loaded as a 1x1 tracking pixel.
Page types where this pixel should fire. Empty list or containing ALL means fire on all pages.
Event triggers that cause this pixel to fire, with optional custom parameters.
Defines a booking funnel event that causes a tracking pixel to fire, together with optional custom key-value parameters sent with the event
object
The event type that triggers this pixel
Custom key-value parameters to include with the event
Key-value parameter passed with a tracking pixel event; values may be static strings or runtime placeholders such as {booking.total}
object
Parameter name (e.g., ‘currency’, ‘value’, ‘content_id’)
Parameter value. Can be a static value or a placeholder like ‘{booking.total}’
Custom font for the booking engine. Null means use the system default.
Example
{ "identifier": "a4f2e8b1-7c5d-4b9a-9e3f-1d6c2a8f5e91", "name": "Luxury Travel Portal", "appendToPageTitle": "Hotels with Benefits", "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "ownerName": "The Siam Residences", "affiliateOwnerIdentifier": "2c5b9e3a-7f1d-4a8c-b6e2-0d4f1a9b3c72", "subType": "APPLICATION", "googleAnalyticsMeasurementId": "G-ABCDEF1234", "googleTagManagerContainerId": "GTM-XXXXX", "googleMapsAPIKey": "AIzaSyC5H2f7Vf6-6b2dZWfZf6-6b2dZWfZf6-6", "defaultCurrency": "THB", "defaultLanguage": "en", "logoImageIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "hostedBookingEngineUrl": "https://book.thesiamresidences.com/reservations", "selfHosted": true, "themeColors": { "primary": "#1a472a", "secondary": "#c9a961", "success": "#28a745", "danger": "#dc3545", "warning": "#ffc107", "info": "#17a2b8", "light": "#f8f9fa", "dark": "#343a40" }, "numberOfAdvanceDays": 7, "numberOfStayDays": 3, "startDate": "2026-07-15", "endDate": "2026-07-22", "roomConfigurations": [ { "adults": 2, "children": 0 } ], "useDays": true, "promotionalCodes": [ "EARLY20", "LOYALTY10" ], "wcBookClickAction": "IBE_MODAL", "showUnavailableCard": false, "showRankings": true, "showSearch": true, "layout": "INFORMATIONAL", "cardLayout": "VERTICAL", "trackingPixels": [ { "identifier": "f8e4b2c9-3a7d-4c1f-9e5b-2d6f1a8c4e73", "name": "Facebook Conversion Pixel", "type": "JAVASCRIPT", "provider": "FACEBOOK", "consentCategory": "MARKETING", "enabled": true, "pixelId": "1234567890" } ], "fontId": "PLAYFAIR_DISPLAY"}Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable