Skip to content

No Inventory

POST
/api/inventory/unavailable
curl --request POST \
--url https://api.wink.travel/api/inventory/unavailable \
--header 'Content-Type: application/json' \
--header 'Wink-Version: 2.0' \
--data '{ "propertyIdentifier": "example", "propertyName": "example", "inventoryName": "example", "inventoryType": "example", "inventoryIdentifier": "example", "userSession": null }'

Notify property that there is a demand but no supply for the specified inventory.

Wink-Version
string
default: 2.0.0
Allowed values: 2.0
Media type application/json
object
propertyIdentifier
required
string
propertyName
required
string
inventoryName
required
string
inventoryType
required
string
inventoryIdentifier
required
string
userSession
required

User session information containing itinerary and other user related data.

object
itinerary
required

Dates and travel info.

object
startDate
required

Start date of itinerary

string format: date
""
Example
2024-01-01
endDate

Optional end date. If endDate is empty, nights needs to be present. If both are present, nights will take precedence.

string format: date
""
Example
2024-01-02
nights

Optional number of nights. If nights is empty, endDate needs to be present. If both are present, nights will take precedence.

integer format: int32
""
items
required

Room configurations

Array<object>
>= 1 items <= 2147483647 items

Room Configuration

object
adults
required

Number of adults

integer format: int32
default: 1 >= 1
Example
2
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
Example
1
hours

Number of hours between start and end dates. Used for itineraries that require bookings that occur within hours and not days. E.g. Meeting room reservation.

integer format: int64
""
children

How many total children for this stay

integer format: int32
""
rooms

How many total rooms for this stay

integer format: int32
""
guests

How many total guests for this stay

integer format: int32
""
language

User’s language preference

string
""
Example
en
currency

User’s currency preference

string
""
Example
USD
promotionalCodes
Array<string>
selectedRoomConfigurationIndex

User can pass the current room configuration index to retrieve rates specifically for that room configuration.

integer format: int32
""
lifestyle

The preferred user lifestyle.

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

Created

Media type application/json
object
propertyIdentifier
required
string
propertyName
required
string
inventoryName
required
string
inventoryType
required
string
inventoryIdentifier
required
string
userSession
required

User session information containing itinerary and other user related data.

object
itinerary
required

Dates and travel info.

object
startDate
required

Start date of itinerary

string format: date
""
endDate

Optional end date. If endDate is empty, nights needs to be present. If both are present, nights will take precedence.

string format: date
""
nights

Optional number of nights. If nights is empty, endDate needs to be present. If both are present, nights will take precedence.

integer format: int32
""
items
required

Room configurations

Array<object>
>= 1 items <= 2147483647 items

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
hours

Number of hours between start and end dates. Used for itineraries that require bookings that occur within hours and not days. E.g. Meeting room reservation.

integer format: int64
""
children

How many total children for this stay

integer format: int32
""
rooms

How many total rooms for this stay

integer format: int32
""
guests

How many total guests for this stay

integer format: int32
""
language

User’s language preference

string
""
currency

User’s currency preference

string
""
promotionalCodes
Array<string>
selectedRoomConfigurationIndex

User can pass the current room configuration index to retrieve rates specifically for that room configuration.

integer format: int32
""
lifestyle

The preferred user lifestyle.

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
{
"userSession": null
}

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