Resolve with session

POST

/api/public/shareable-link/{code}

const url = 'https://api.wink.travel/api/public/shareable-link/WNK7A?cid=summer-promo-2026&_gl=';
const options = {
  method: 'POST',
  headers: {
    'User-Agent': '',
    Host: '',
    Referer: '',
    'Wink-Version': '2.0',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: 'null'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url 'https://api.wink.travel/api/public/shareable-link/WNK7A?cid=summer-promo-2026&_gl=' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Host: ' \
  --header 'Referer: ' \
  --header 'User-Agent: ' \
  --header 'Wink-Version: 2.0' \
  --data null

Resolves a 5-character share code into its bookable inventory, merging the posted user session and the caller’s geo-IP location, and records a view.

Authorizations

oauth2ClientCredentials

Parameters

Path Parameters

code

required

string

Five-character share code for the shortened URL

Example

WNK7A

Header Parameters

User-Agent

string

User-Agent header from the request

Host

string

Host header from the request

Referer

string

Referrer header from the request

Wink-Version

string

default: 2.0.0

Allowed values: 2.0

Query Parameters

cid

string

Campaign identifier for tracking purposes

Example

summer-promo-2026

_gl

string

Google Analytics 4 cross-site link ID

Request Body^required

application/json

User session information containing itinerary and other user related data.

object

itinerary

required

Dates and travel info.

object

startDate

required

Check-in date (must be today or in the future)

string format: date

Example

2026-07-15

endDate

Check-out date (alternative to nights; nights takes precedence if both provided)

string format: date

Example

2026-07-18

nights

Number of nights for the stay (alternative to endDate; takes precedence if both provided)

integer format: int32

Example

items

required

Room configurations for each room in the reservation

Array<object>

>= 1 items <= 2147483647 items

Room occupancy and guest composition for a single or multiple identical rooms

object

adults

required

Number of adult guests in this room type

integer format: int32

default: 1 >= 1

Example

children

Child guests in this room, with age groups

Array<object>

Child guest with age and quantity in a room configuration

object

quantity

required

Count of children of this age group in the room

integer format: int32

"" >= 1

Example

age

required

Age of each child in this group (years)

integer format: int32

Example

quantity

Number of identical rooms with this configuration

integer format: int32

default: 1 >= 1

Example

hours

Duration in hours (rounded up) between check-in and check-out. Used for hourly bookings; e.g., meeting rooms or day-use venues.

integer format: int64

Example

children

Total number of children across all rooms

integer format: int32

Example

rooms

Total number of rooms in this itinerary

integer format: int32

Example

guests

Total number of adult guests across all rooms

integer format: int32

Example

language

User’s language preference (ISO 639-1 code)

string

Example

en

currency

User’s currency preference (ISO 4217 code)

string

Example

USD

promotionalCodes

Array<string>

selectedRoomConfigurationIndex

Index of the currently selected room configuration for rate retrieval

integer format: int32

Example

lifestyle

Preferred lifestyle category to filter accommodations

string

Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO

Example

LIFESTYLE_RELAX

Responses

200

application/json

object

type

required

The type of document the uniqueId links to

string

Allowed values: SELLABLE_INVENTORY_SLUG SELLABLE_SUPPLIER_SLUG AFFILIATE_ACCOUNT_SLUG SYNDICATED_ITEM_SLUG URL

language

required

Which language the seller wanted to use

string

default: en >= 1 characters

currency

Which currency the seller is using

string

default: USD

title

required

Link title

string

"" >= 1 characters

description

required

Link description

string

"" >= 1 characters

keywords

Comma-separated keyword values that can be used to populate HTML metadata

string

uniqueId

required

The URL ID that uniquely represents this link

string

"" >= 1 characters

twitterAccount

Optional X account ID

string

facebookAppId

Optional Facebook app ID

string

thirdPartyGoogleMeasurementId

Optional 3rd party GA4 Measurement ID

string

thirdPartyGoogleTagManagerContainerId

Optional 3rd party GTM Container ID

string

image

The image you want to accompany this link

object

channel

string

Allowed values: FACEBOOK INSTAGRAM LINKED_IN TWITTER REDDIT

url

string

width

integer format: int32

height

integer format: int32

type

string

Allowed values: IMAGE VIDEO

mimeType

string

altText

string

video

The video you want to accompany this link

object

channel

string

Allowed values: FACEBOOK INSTAGRAM LINKED_IN TWITTER REDDIT

url

string

width

integer format: int32

height

integer format: int32

type

string

Allowed values: IMAGE VIDEO

mimeType

string

altText

string

transactUrl

required

The transation url, or where to redirect to when clicking the CTA button.

string

"" >= 1 characters

Example

{
  "type": "SELLABLE_INVENTORY_SLUG",
  "language": "en",
  "currency": "USD",
  "title": "",
  "description": "",
  "keywords": "",
  "uniqueId": "",
  "twitterAccount": "",
  "facebookAppId": "",
  "thirdPartyGoogleMeasurementId": "",
  "thirdPartyGoogleTagManagerContainerId": "",
  "image": "",
  "video": "",
  "transactUrl": ""
}

400

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"
  }
}

401

Unauthorized

*/*

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

403

Forbidden

*/*

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

500

Internal Server Error

object

Example ^generated

{}

Resolve with session

Authorizations

Parameters

Path Parameters

Example

Header Parameters

Query Parameters

Example

Request Body required

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Responses

200

Example

400

Example generated

401

403

500

Example generated

Request Body^required

Example ^generated

Example ^generated