Availability Feed

The Availability feed returns a list of all departures for the trips listed in the Product feed. It includes the travel dates, number of spaces available, departure ‘sell’ status (e.g. “on request”, “booking closed”, “departure guaranteed” etc.) and prices and discounts in various currencies. A request can also be made to return the same information for an individual product code. As the XML for dates and availability for all products is very large it is recommended that you only request this feed for an individual product code.

Note: This example feed is only showing a single departure, but the full feed will include all departures. Due to the size of the full feed it is recommended that you generally only request this feed for individual products.

Click for example

Data structure

XML Element
Required?
Data Type
Notes
feed [type=<feedType>, brand=<brand>]
Top-level XML tag
<departureList>
Optional
departureList
{departure}
Mandatory
departure
<summary>
Mandatory
<statuses>
Optional
<pricesList>
Optional
<singleSupplementPriceList>
Optional
<extraList>
Optional
summary
productCode
Mandatory
string
productName
Mandatory
string
shipName
Optional
string
Only available for VRTT products
departureID
Mandatory
string
departureCode
Mandatory
string
departureName
Mandatory
string
startDate
Mandatory
string
Date Format: DDMMMYYY 
e.g. 01JAN2016
finishDate
Mandatory
string
Date Format: DDMMMYYY 
e.g. 01JAN2016
startCity
Optional
string
finishCity
Optional
string
flightInclusiveStartDate
Optional
string
Date Format: DDMMMYYY
e.g. 01JAN2016
flightInclusiveFinishDate
Optional
string
Date Format: DDMMMYYY 
e.g. 01JAN2016
flightInclusiveStartCity
Optional
string
flightInclusiveFinishCity
Optional
string
startPoint
Optional
string
finishPoint
Optional
string
statuses
availability
Optional
int
freeSell
Optional
bool
onRequest
Optional
bool
lateRequest
Optional
bool
bookingClosed
Optional
bool
departureGuaranteed
Optional
bool
pricesList
{prices}
Mandatory
prices
[productVersion=<productVersionType> currency=<currency>, numPax=<numPax>,paxType=<paxType>, roomType=<roomType>
When attribute numPax is not present the price is for a single person
base
Optional
decimal
discount
Optional
decimal
kitty [currency]
Optional
decimal
total
Optional
decimal
singleSupplementPriceList
singleSupplementPrice [currency]
Mandatory
decimal
extraList
{extra}
Mandatory
extra [currency]
description
Optional
string
amount
Optional
decimal