How can I become a Travelgate Partner?

Visit our platform, click “Contact Travelgate,” and submit the short form—it takes about two minutes. Our partnerships team will follow up promptly to get you started.

What are the benefits of using the Travelgate app?

The Travelgate app allows you to manage bookings, monitor performance, and access real-time insights on the go. It's a powerful tool for travel businesses to stay connected and efficient.

What resources are available for onboarding?

Travelgate offers a comprehensive onboarding guide, including certification resources, API documentation, and customer success support.

How can I access the Hotel-X API Playground?

Access the Hotel-X API Playground via the Travelgate documentation to explore and test API queries, customize GraphQL requests, and view real-time responses in a safe development environment.

How can I troubleshoot common API errors?

For common API errors, refer to our Errors and Warnings list. It provides detailed steps to resolve issues like timeouts, communication errors, and data retrieval problems.

What is the importance of uptime in Travelgate?

Uptime is critical for ensuring seamless connectivity and uninterrupted service. Travelgate prioritizes high availability to minimize disruptions and maximize operational efficiency.

What payment methods does Travelgate support?

Travelgate supports multiple payment methods, including credit cards, virtual credit cards (VCC), and other supplier-specific payment types. For more details, check our payment guide.

Hotels

The Hotels Query allows you to retrieve hotel information in two ways:

The FastX Hotel List, a unified list of all unique hotels available to you in the Travelgate Marketplace. These FastX codes are the ones used throughout the booking flow.
The Supplier Hotel List, which provides the hotel information returned for each connected Seller.

This flexibility lets you work with both standardized FastX codes for a seamless integration and the original Supplier data when you need full visibility into each Partner’s portfolio.

The returned fields include:

hotelCode
hotelName
giataData
location
allAmenities
medias
descriptions

Query Overview

When creating your hotels query, you have two different inputs to fill based on your specific needs:

Criteria
Token

1. Criteria

This query offers versatility, with certain fields marked as mandatory (access) and others as optional (hotelCodes, countries, destinationCodes, etc.). This flexibility empowers you to create a personalized Hotels Query, tailoring the requested fields to your specific needs. Consequently, the response will only include information that is highly relevant to you, streamlining the retrieval process and ensuring the data you receive meets your exact requirements.

{
	"criteriaHotels": {
		"access": "2",
		"hotelCodes": [
			"91415"
		],
		"maxSize": 5
	}
}

Mandatory criteria

access

Optional criteria

hotelCodes (Search by hotel)
countries (Search by country)
destinationCodes (Search by destination)
maxSize (Paginate response)

2. Token

The HotelX API provides paginated responses to handle cases where the number of hotels from the requested access exceeds 500. The default response page contains 500 hotels, but you can specify the number of objects returned per page using the maxSize field in the criteria variable explained before to retrieve between 1 and 500 hotels.

To include the token in your request, all you need to do is:

Add the token object to the fields and variables.
After receiving a response, you will only receive a portion of the full list. To access the next page, simply copy the token tag from the response and include it in your next request. This will allow you to obtain a new set of objects in the following response.
Repeat these steps until the token is no longer included in the response, the query will return “Hotels not found”.

Query variables

First, in your hotels query you won't indicate any token input:

{
    "criteriaHotels" : {
        "access" : "2",
        "maxSize" : 5
    },
    "token" : ""
}

You will obtain a response with 5 hotels per page:

Response (truncated):

{
  "data": {
    "hotelX": {
      "hotels": {
        "token": "FGluY2x1ZGVfY29udGV4dF91dWlkDnF1ZXJ5VGhlbkZl...",
        "edges": [ {...}, {...} ]
      }
    }
  }
}

Example — Next Page (include token):

{
  "criteriaHotels": {
    "access": "2",
    "maxSize": 5
  },
  "token": "FGluY2x1ZGVfY29udGV4dF91dWlkDnF1ZXJ5VGhlbkZl..."
}

Response Considerations

note

The amount of information and content returned might vary between Sellers.

HotelX supports all languages, but receiving hotel descriptions in one or another depends entirely on the languages supported by the Seller.

Query Inputs

HotelXHotelListInput (INPUT_OBJECT)

access(ID)

Indicates the access

hotelCodes(String)

Search by hotel codes. These hotel codes are used to perform search.

supplierHotelCodes(String)

Search by hotel codes in supplier s context.

hotelName(String)

Search by hotel name

destinationCodes(String)

Search by destination codes, only search by minimal destinations

countries(Country)

Filter by country

ranks(Int)

Filter by supplier rank

maxSize(Int)

Maxium number of items per page

group(ID)

The supplier s group. Only available if all permissions allowed

supplierCode(ID)

The supplier s unique code

token (String)
A unique authentication token required for API requests.

Returned Fields

HotelConnection (OBJECT)
HotelList definition

edges(HotelEdge)

node(Hotel)

code * (ID)

Hotel ID

hotelData(HotelData)

Hotel data

code * (ID)

Internal code.

hotelCode * (String)

Code to perform availability.

hotelCodeSupplier(String)

Native supplier hotel code.

giataData(GiataData)

Giata data stored in giata.

id * (ID)

Giata System ID.

source(URI)

Giata URL for the hotels of the supplier.

href(URI)

Giata url for the hotel info.

updatedAt * (DateTime)

Date of last Giata update for this code.

hotelName(String)

Name of the hotel in the Supplier selected.

categoryCode(String)

Hotel category (for example number of stars).

chainCode(String)

Hotel chain code

exclusiveDeal * (Boolean)

Indicates that the Hotel has an Exclusive Deal.

location * (Location)

Indicates the location of the hotel

address(String)

Contains Hotel Address

city(String)

Contains the city

zipCode(String)

Contains the zipCode.

country(Country)

Country where is the Hotel.

coordinates(Coordinates)

Geographical coordinates corresponding to a location.

latitude * (Float)

Latitude

longitude * (Float)

Longitude

closestDestination(DestinationData)

Closest destination

code * (ID)

Destination Code

available * (Boolean)

Indicates if you can search by destination

destinationLeaf(String)

Returns destination leafs of the destination.

texts * (Text)

Contains the destination name

text * (String)

language * (Language)

closestDestinations(String)

Closest destinations, indicates destinations in proximity

parent(String)

Parent destination code

type(DestinationType)

Indicates destination type, zone or city Possible values:

ZONE: Zone
CITY: City

airports(Airport)

Airports

code * (ID)

Airport ID

airportData(AirportData)

Airport data

code * (ID)

Airport Code (IATA)

name(String)

The airport s name

location(Location)

The airport s location

adviseMessage(AdviseMessage)

List of messages

code * (ID)

AM code: The following codes can be returned:

description * (String)

Error description

level * (AdviseMessageLevel)

Indicates the level of importance of the message. Possible values: ERROR, WARN, INFO. Possible values:

WARN: Warning message.
ERROR: Error message.
INFO: Info message.

external(ExternalMessage)

Specify the external message.

code(String)

External code.

message * (String)

External message.

correlationID * (ID)

Identifier to investigate the cause of the error.

createdAt * (DateTime)

Date created

updatedAt * (DateTime)

Date updated

state(State)

the state/province of the property

contact(Contact)

Contact contains information about hotel contact.

email(String)

telephone(String)

Telephone

fax(String)

Fax

web(URI)

Web

rank * (Int)

Rank indicates the supplier categorization.

cardTypes(PaymentCardType)

List of credit cards Possible values:

VI: Visa
AX: American Express
BC: BC Card
CA: MasterCard
CB: Carte Blanche
CU: China Union Pay
DS: Discover
DC: Diners Club
T: Carta Si
R: Carte Bleue
N: Dankort
L: Delta
E: Electron
JC: Japan Credit Bureau
TO: Maestro
S: Switch
EC: Electronic Cash
EU: EuroCard
TP: universal air travel card
OP: optima
ER: Air Canada/RnRoute
XS: access
O: others

medias(Media)

Medias

code(String)

Code.

order(String)

Indicates the order priority.

type * (ApplicationAreaType)

Indicates the type of the media. Possible values:

HOTEL: Apply at the hotel.
ROOM: Apply in the hotel.
SERVICE: Applies to a service.
GENERAL: Applies in general.

updatedAt * (DateTime)

Date updated.

url * (URI)

Url.

texts(Text)

Contains the descriptive.

text * (String)

language * (Language)

descriptions(Description)

Descriptions

type * (DescriptionType)

Indicates type of description Possible values:

ADDITIONAL: Additional Information
AMENITY: Amenities
ACTIVITY: Activities
RESTAURANT: Restaurants
ROOM: Rooms
GENERAL: General
POOL: Pools
LOCATION: Locations
HOW_TO_GET: How to get

texts(Text)

Label

text * (String)

language * (Language)

rooms(RoomConnection)

Rooms

edges(RoomEdge)

node(RoomStatic)

code * (ID)

Room ID

roomData(RoomData)

Room data

code * (ID)

Internal code for checking availability

roomCode * (String)

Code of the hotel in the Supplier selected

texts(Text)

Label

text * (String)

language * (Language)

source(String)

Room source

occupancies(OccupancyStatic)

Room occupancies

total(OccupancyRange)

Occupancy Total Pax Range

min(Int)

max(Int)

infants(OccupancyRange)

Occupancy Infants Pax Range

min(Int)

max(Int)

children(OccupancyRange)

Occupancy Children Pax Range

min(Int)

max(Int)

adults(OccupancyRange)

Occupancy Adults Pax Range

min(Int)

max(Int)

views(View)

Room views

texts(Text)

Contains the descriptive of view.

text * (String)

language * (Language)

viewCode * (String)

Containg the view code

medias(Media)

Room medias

code(String)

Code.

order(String)

Indicates the order priority.

type * (ApplicationAreaType)

Indicates the type of the media. Possible values:

HOTEL: Apply at the hotel.
ROOM: Apply in the hotel.
SERVICE: Applies to a service.
GENERAL: Applies in general.

updatedAt * (DateTime)

Date updated.

url * (URI)

Url.

texts(Text)

Contains the descriptive.

text * (String)

language * (Language)

beds(BedStatic)

Room beds

type(String)

Specifies the bed type

count(Int)

Indicates number of beds in a room

shared(Boolean)

Specifies if the bed is shared or not

area(Area)

Room area in square meters.

allAmenities(HotelXAmenityConnection)

Amenities with mapping

edges(HotelXAmenityEdge)

Amenity edges of amenity connection

node * (HotelXAmenity)

Amenity node

code * (ID)

Node Id

amenityData(HotelXAmenityData)

Indicates data values of amenity

adviseMessage(AdviseMessage)

List of messages

createdAt * (DateTime)

Indicates the creation date of the node

updatedAt * (DateTime)

Indicates the date of last update of the node

cursor * (String)

Edge s cursor

adviseMessage(AdviseMessage)

List of messages

code * (ID)

AM code: The following codes can be returned:

description * (String)

Error description

level * (AdviseMessageLevel)

Indicates the level of importance of the message. Possible values: ERROR, WARN, INFO. Possible values:

WARN: Warning message.
ERROR: Error message.
INFO: Info message.

external(ExternalMessage)

Specify the external message.

code(String)

External code.

message * (String)

External message.

correlationID * (ID)

Identifier to investigate the cause of the error.

createdAt * (DateTime)

Date created

updatedAt * (DateTime)

Date updated

cursor * (String)

token(String)

propertyType(PropertyType)

Indicates property type.

propertyCode(String)

Native supplier property code.

name(String)

PropertyType name

mandatoryFees(MandatoryFee)

Mandatory fees of property

duration(String)

Fee duration

mandatoryFeeCode * (String)

Native supplier Mandatry Fee

price * (PriceStatic)

Fee price

amount * (Float)

Net amount

currency * (Currency)

Price curency

scope(String)

The scope of the fee

name(String)

the name of the fee

text(String)

Fee description

included * (Boolean)

Indicates if the fee is included in the price

checkIn(CheckInformation)

CheckIn information

instructions(Text)

CheckIn instructions

text * (String)

language * (Language)

specialInstructions(Text)

CheckIn special instructions

text * (String)

language * (Language)

minAge(Int)

Minimal age allowed for doing the checkin

schedule(TimeRange)

The schedule of checkIn

startTime(Time)

the start time of range

endTime(Time)

the end time of range

checkOut(CheckInformation)

CheckOut information

instructions(Text)

CheckIn instructions

text * (String)

language * (Language)

specialInstructions(Text)

CheckIn special instructions

text * (String)

language * (Language)

minAge(Int)

Minimal age allowed for doing the checkin

schedule(TimeRange)

The schedule of checkIn

startTime(Time)

the start time of range

endTime(Time)

the end time of range

accesses(String)

Accesses that has this hotel

allAmenities(HotelXAmenityConnection)

Amenities with mapping

edges(HotelXAmenityEdge)

Amenity edges of amenity connection

node * (HotelXAmenity)

Amenity node

code * (ID)

Node Id

amenityData(HotelXAmenityData)

Indicates data values of amenity

code * (ID)

Amenity code

amenityCode * (String)

External amenity code

type * (ApplicationAreaType)

Indicates the type of Amenity. Possible values:

HOTEL: Apply at the hotel.
ROOM: Apply in the hotel.
SERVICE: Applies to a service.
GENERAL: Applies in general.

texts * (Text)

Contains the descriptive

text * (String)

language * (Language)

value * (Text)

Indicates the amenity s value in different languages

text * (String)

language * (Language)

mappings(HotelXMappedCode)

Mappings of amenity codes in different contexts

context * (String)

Context of the mapped code

code * (String)

Code in context

adviseMessage(AdviseMessage)

List of messages

code * (ID)

AM code: The following codes can be returned:

description * (String)

Error description

level * (AdviseMessageLevel)

Indicates the level of importance of the message. Possible values: ERROR, WARN, INFO. Possible values:

WARN: Warning message.
ERROR: Error message.
INFO: Info message.

external(ExternalMessage)

Specify the external message.

code(String)

External code.

message * (String)

External message.

correlationID * (ID)

Identifier to investigate the cause of the error.

createdAt * (DateTime)

Indicates the creation date of the node

updatedAt * (DateTime)

Indicates the date of last update of the node

cursor * (String)

Edge s cursor

mappings(HotelXMappedCode)

Mapping codes for this property in various contexts, e.g.: TGX, GIATA,...

context * (String)

Context of the mapped code

code * (String)

Code in context

adviseMessage(AdviseMessage)

List of messages

code * (ID)

AM code: The following codes can be returned:

description * (String)

Error description

level * (AdviseMessageLevel)

Indicates the level of importance of the message. Possible values: ERROR, WARN, INFO. Possible values:

WARN: Warning message.
ERROR: Error message.
INFO: Info message.

external(ExternalMessage)

Specify the external message.

code(String)

External code.

message * (String)

External message.

correlationID * (ID)

Identifier to investigate the cause of the error.

createdAt * (DateTime)

Date created

updatedAt * (DateTime)

Date updated

cursor * (String)

count * (Int)

token(String)

Use Cases

FastX master hotel list

To retrieve the FastX Hotel Master, make a hotel list call using your FastX access, which you can find in the MyConnections section under the Seller "Travelgate". This returns the complete list of unique hotels available to you across all connected Suppliers. As you add new Sellers, any new properties they provide — not already offered by your other connected Suppliers — are automatically included in your master list.

FastX Content

When performing a Hotels Query using the FastX access, the following fields are currently returned:

Hotel code
Hotel name
Country
Address
Latitude / Longitude
GIATA ID (if this functionality has been activated)

Need complete, unified static content too? Activate FastX Content by AO to add complete and standardized hotel and room content for each FastX code, including descriptions, images, amenities, and more.

Supplier hotel list

To retrieve only one Supplier's portfolio, include that Supplier's access in the query (for example, access 2 for the Travelgate Test supplier).

The response returns the Supplier's native static content, so the available data depends on what that Seller provides. In this case, hotelCode corresponds to the Supplier's native hotel code, and you can also find the matched FastX code in the mappings field.

note

The amount of information and content returned might vary between Sellers.

HotelX supports all languages, but receiving hotel descriptions in one or another depends entirely on the languages supported by the Seller.

Hotel list of specific hotel codes

If you want to retrieve the information of specific hotel codes, you will need to specify the codes in the hotelCodes field:

Hotel list by country

When utilizing the Hotels List Query, for more personalized results, filter specific hotels, countries or destinations based on your interests. For example, to focus solely on the inventory of all your Sellers in Greece, add the countries field with "GR" in your criteria. This will ensure you receive hotels directly related to that country, providing you with highly targeted and relevant information.

Hotel list by destination

Filter hotels by destination zone. For example, to retrieve only hotels in Santorini, use the destination code that the Supplier has assigned (e.g., "101402" for Santorini in the test Supplier). Include this code in the destinationCodes field:

Frequently Asked Questions

How can I obtain the GIATA code?

GIATA codes are supported in the HotelX Hotels Query response at the hotel level. To activate this feature:

Open a ticket with Customer Care, providing your GIATA credentials and the Sellers for which you want GIATA codes.
Once activated, include the giataData node in your Hotels Query to receive GIATA details in the response.

Request

query {
    hotelX {
		hotels(criteria: {access: "2"}) {
			edges {
				cursor
				node {
					code
					hotelData {
						hotelCode
						hotelName
						giataData {
						updatedAt
						source
						href
						}
						...
					}
				}
			}
		}
	}
}

Response

{
	"data": {
		"hotelX": {
			"hotels": {
				"edges": [
					{
						"cursor": "",
						"node": {
							"code": "",
							"hotelData": {
								"hotelCode": "66337",
								"hotelName": "Hotel Test",
								"giataData": "11267",
								...
							}
						}
					}
				]
			}
		}
	}
}

Can I get the total property count without fetching all hotels?

Yes. Add the count field to your Hotels Query to retrieve the total number of properties. You can request count alone without edges if you only need the total.

Request

query {
    hotelX {
		hotels(criteria: {access: "2"}) {
			count
			edges {
				...
			}
		}
	}
}

Response

{
	"data": {
		"hotelX": {
			"hotels": {
				"count": 16,
				"edges": [
					...
				]
			}
		}
	}
}

How can I obtain GIATA codes?

GIATA codes are supported at the hotel level and must be activated first. Setup steps:

Open a ticket with Customer Care with your GIATA credentials and the Suppliers you want to activate GIATA for.
Once enabled, include the giataData node in your Hotels Query to receive GIATA identifiers.

Request

query {
    hotelX {
		hotels(criteria: {access: "2"}) {
			edges {
				cursor
				node {
					code
					hotelData {
						hotelCode
						hotelName
						giataData {
						updatedAt
						source
						href
						}
						...
					}
				}
			}
		}
	}
}

Response

{
	"data": {
		"hotelX": {
			"hotels": {
				"edges": [
					{
						"cursor": "",
						"node": {
							"code": "",
							"hotelData": {
								"hotelCode": "66337",
								"hotelName": "Hotel Test",
								"giataData": "11267",
								...
							}
						}
					}
				]
			}
		}
	}
}

Query Overview​

1. Criteria​

2. Token​

Response Considerations​

Query Inputs​

Returned Fields​

Use Cases​

FastX master hotel list​

Supplier hotel list​

Hotel list of specific hotel codes​

Hotel list by country​

Hotel list by destination​

Frequently Asked Questions​

Query Overview

1. Criteria

2. Token

Response Considerations

Query Inputs

Returned Fields

Use Cases

FastX master hotel list

Supplier hotel list

Hotel list of specific hotel codes

Hotel list by country

Hotel list by destination

Frequently Asked Questions