Skip to content

Load Configuration by Client ID

GET
/api/public/configuration/client/{clientId}
curl --request GET \
--url https://api.wink.travel/api/public/configuration/client/ \
--header 'Wink-Version: 2.0'

Retrieve affiliate configuration by clientId in the path

clientId
required
string
""

The clientId

Wink-Version
string
default: 2.0.0
Allowed values: 2.0

OK

Media type application/json
object
identifier

Unique customization configuration identifier

string format: uuid
""
name
required

Engine configuration name

string
"" >= 1 characters
appendToPageTitle

Whether to append text to the existing booking customization page title.

string
""
ownerIdentifier

Engine configuration record creator identifier

string format: uuid
""
ownerName

Name of company owner.

string
""
subType

Sales channel sub-type.

string
""
Allowed values: TRIP_PAY FACILITATOR DIRECT APPLICATION HOTEL TRAVELIKO CORPORATE TRAVEL_AGENT INFLUENCER BLOGGER DESTINATION CHANNEL_MANAGER PROPERTY_MANAGEMENT_SYSTEM CENTRAL_RESERVATION_SYSTEM GOOGLE_HOTEL_API MANAGEMENT_COMPANY CHAIN BRAND EVENT_ORGANIZER OTHER
primary

Indicates whether this configuration is primary. A primary configuration cannot be removed.

boolean
googleAnalyticsMeasurementId

If you want to track analytics with Google Analytics using your GA4 Measurement ID.

string
""
googleTagManagerContainerId

If you want to track analytics and you have a GTM Container ID, enter it here.

string
""
googleMapsAPIKey

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.

string
""
defaultCurrency

Control which currency your users see prices in initially.

string
default: USD
defaultLanguage

Control which language your users see text in initially.

string
default: en
logoImageIdentifier

Customize booking confirmation emails by adding a custom logo to your configuration.

string
""
hostedBookingEngineUrl

If you are self-hosting our booking customization, let us know where it is hosted. Note: This url needs to be secured with SSL.

string
default: https://ota.wink.travel
selfHosted

Flag to indicate you are self-hosting our booking customization and not using our default booking customization url.

boolean
themeColors

Choose how you want our web components to look and more closely match with your own site style.

object
primary

Primary color

string
default: #dc3545
secondary

Secondary color

string
default: #6c757d
success

Success color

string
default: #28a745
danger

Danger color

string
default: #dc3545
warning

Warning color

string
default: #ffc107
info

Info color

string
default: #17a2b8
light

Light color

string
default: #f8f9fa
dark

Dark color

string
default: #343a40
body

Body color

string
default: #212529
muted

Muted color

string
default: #6c757d
white

White color

string
default: #ffffff
numberOfAdvanceDays

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.

integer format: int32
""
numberOfStayDays

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.

integer format: int32
""
startDate

Set a fixed itinerary start date. ONLY populate this field if you want to fix the itinerary date. Also, leave numberOfAdvanceDays and numberOfStayDays empty.

string format: date
""
endDate

Set a fixed itinerary end date ONLY populate this field if you want to fix the itinerary date. Also, leave numberOfAdvanceDays and numberOfStayDays empty.

string format: date
""
roomConfigurations

Control how many adults / children will be staying and how many rooms. Defaults to: One room, two adults.

Array<object>
""

Room Configuration

object
adults
required

Number of adults

integer format: int32
default: 1 >= 1
children

Children configurations

Array<object>

BookingItineraryRoomConfigurationChild configuration

object
quantity
required

Number of children

integer format: int32
"" >= 1
age
required

Age of children

integer format: int32
""
quantity

Number of identical rooms of this configuration being booked

integer format: int32
default: 1 >= 1
useDays

If true, we use numberOfAdvanceDays / numberOfStayDays properties - false, we use startDate / endDate

boolean
promotionalCodes

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.

Array<string>
""
wcBookClickAction

Action to complete once a user clicks on the CTA button on inventory.

string
""
Allowed values: FORWARD_TO_IBE IBE_MODAL
showUnavailableCard

Show unavailable inventory card when inventory not currently for sale. Otherwise, it displays a normal card but without the price.

boolean
showRankings

Whether to display rankings (lifestyle, eco score and reviews) on hotel landing page.

boolean
showSearch

This feature flag controls whether to let a user move away from the hotel landing page using search.

boolean
layout

Choose how you want our web component cards laid out.

string
default: INFORMATIONAL
Allowed values: INFORMATIONAL TRANSACTIONAL
cardLayout

Choose how you large you want our web component cards to be.

string
default: VERTICAL
Allowed values: HORIZONTAL VERTICAL
trackingPixels

Tracking pixels to fire on key booking events.

Array<object>
""
object
identifier
required

Unique identifier for this tracking pixel

string format: uuid
"" >= 1 characters
name
required

User-friendly name for this tracking pixel

string
"" >= 1 characters
type
required

Type of tracking pixel delivery mechanism

string
""
Allowed values: JAVASCRIPT IMAGE
provider
required

Tracking pixel provider

string
""
Allowed values: FACEBOOK GOOGLE_ADS GOOGLE_ANALYTICS TIKTOK LINKEDIN PINTEREST SNAPCHAT TWITTER SOJOURN CUSTOM
consentCategory
required

Consent category for GDPR/CCPA compliance

string
""
Allowed values: STRICTLY_NECESSARY FUNCTIONAL ANALYTICS MARKETING
enabled

Whether this tracking pixel is currently active

boolean
default: true
pixelId

Provider-specific pixel ID (e.g., Facebook Pixel ID, Google Ads Conversion ID)

string
""
accessToken

Optional access token for providers that require authentication

string
""
customScript

Custom JavaScript code for CUSTOM provider type. Will be injected into the page.

string
""
customImageUrl

Custom image URL for IMAGE type pixels. Will be loaded as a 1x1 tracking pixel.

string
""
pageTypes

Page types where this pixel should fire. Empty list or containing ALL means fire on all pages.

Array<string>
""
Allowed values: ALL LANDING_PAGE SEARCH_RESULTS ROOM_SELECTION CHECKOUT CONFIRMATION
triggers

Event triggers that cause this pixel to fire, with optional custom parameters.

Array<object>
""
object
eventType
required

The event type that triggers this pixel

string
""
Allowed values: PAGE_VIEW SEARCH VIEW_CONTENT ADD_TO_CART INITIATE_CHECKOUT ADD_PAYMENT_INFO PURCHASE LEAD SIGN_UP
parameters

Custom key-value parameters to include with the event

Array<object>
""
object
key
required

Parameter name (e.g., ‘currency’, ‘value’, ‘content_id’)

string
"" >= 1 characters
value
required

Parameter value. Can be a static value or a placeholder like ‘{booking.total}’

string
"" >= 1 characters
fontId

Custom font for the booking engine. Null means use the system default.

string
""
Allowed values: UI_SANS_SERIF UI_SERIF PLAYFAIR_DISPLAY LIBRE_BASKERVILLE CORMORANT_GARAMOND JOSEFIN_SANS RALEWAY LORA SPACE_GROTESK DM_SERIF_DISPLAY OUTFIT CRIMSON_PRO CINZEL BODONI_MODA EB_GARAMOND ITALIANA FORUM TENOR_SANS GILDA_DISPLAY MARCELLUS
Example
{
"identifier": "",
"name": "",
"appendToPageTitle": "",
"ownerIdentifier": "",
"ownerName": "",
"subType": "TRIP_PAY",
"primary": false,
"googleAnalyticsMeasurementId": "",
"googleTagManagerContainerId": "",
"googleMapsAPIKey": "",
"defaultCurrency": "USD",
"defaultLanguage": "en",
"logoImageIdentifier": "",
"hostedBookingEngineUrl": "https://ota.wink.travel",
"selfHosted": false,
"themeColors": "",
"numberOfAdvanceDays": "",
"numberOfStayDays": "",
"startDate": "",
"endDate": "",
"roomConfigurations": "",
"useDays": false,
"promotionalCodes": "",
"wcBookClickAction": "FORWARD_TO_IBE",
"showUnavailableCard": false,
"showRankings": false,
"showSearch": false,
"layout": "INFORMATIONAL",
"cardLayout": "HORIZONTAL",
"trackingPixels": "",
"fontId": "UI_SANS_SERIF"
}

Bad Request

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"instance": "https://example.com",
"properties": {
"additionalProperty": "example"
}
}

Unauthorized

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

Forbidden

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

Internal Server Error

object
Example generated
{}