Search AOT Number

The Search AOT Number request provides the client with static data relating to the AOT numbers the customers can call while travelling and whenever unable to call the client directly. The API will provide a list of countries and their corresponding AOT numbers for the language required.

Example XML Search AOT Number request

The XML message below gives a sample of the expected elements needed by the API to execute a Search AOT Number Request.

<?xml version="1.0" encoding="UTF-8"?>
<Request>
  <Source>
<RequestorID Client="123456" EMailAddress="clientName@client.co.uk" Password="clientPassword" />
    <RequestorPreferences Language="en">
		  <RequestMode>SYNCHRONOUS</RequestMode> 
    </RequestorPreferences>
  </Source>
	<RequestDetails>
		<SearchAOTNumberRequest>
       <AssistanceLanguage />
       <Destination>AU</Destination>
			 <Nationality>GB</Nationality>
       <ServiceType>hotel</ServiceType>
		</SearchAOTNumberRequest>
	</RequestDetails>
</Request>

Source parameters

Please refer to the API Architecture document.

Search AOT Number parameters

A Search AOT Number request can contain optional parameters to filter the list of AOT numbers returned.  The following lists the parameters that can be specified: -

Parameter

Description

AssistanceLanguage

Optional. If specified only AOT Numbers for the specified language will be returned.

N.B.: if the language required is not available the result will return for English language support.

Destination

Optional. If specified only AOT Numbers for the specified destination will be returned.

Nationality

ISO 3166 format, 2 letter

Mandatory. Only AOT Numbers for the specified passenger nationality will be returned.

ServiceType

Mandatory. Only AOT Numbers for the specified service type will be returned.

N.B.: Currently all AOT Numbers are shared for all service types.

 Example XML Search AOT Number response

The XML message below gives a sample of that given by the API in response to a Search AOT Number request.

<?xml version="1.0" encoding="UTF-8"?>

<Response ResponseReference=" REF_749-466-288315526413579">

       <ResponseDetails Language="en">

    <SearchAOTNumberResponse>

      <ContactDetails>

        <Destination Code="AU">

          <Description><![CDATA[AUSTRALIA]]></Description>

            <Offices>

              <Office>

                <OfficeLocation><![CDATA[Sydney]]></OfficeLocation>

                <AssistanceLanguages>

                  <AssistanceLanguage>

                    <Language Code="en"><![CDATA[English]]></Language>

                    <OfficeHours>09:00 - 17:30</OfficeHours>

                    <AOTNumbers>

                      <International>61-2-99013316</International>

                      <National>02-99013316</National>

                      <Local>99013316</Local>

                    </AOTNumbers>

                  </AssistanceLanguage>

                </AssistanceLanguages>

              </Office>

            </Offices>

          </Destination>

        </ContactDetails>

      </SearchAOTNumberResponse>

        </ResponseDetails>

 </Response>

Search AOT Numbers response parameters

The following parameters can form part of the <SearchAOTNumbersResponse>: -

Parameter

Description

Destination

The country the passenger is travelling to.

 

Attribute

Description

 

Code

The unique country code held by GTA

 

Parameter

Description

Description

The name of the country the passenger is travelling to.

Offices

A list of gta offices that can support passengers travelling in the specified country.

Offfice

The details of the office supporting passengers travelling in the specified country.

OfficeLocation

The name of the city the office that will answer the AOT call is located in.

AssistanceLanguage

Specify the list of one or more languages in which assistance can be given under the specified phone number.

Langauge

Language name in which assistance can be given under the specified phone number.

 

Attribute

Description

 

Code

The unique language code held by GTA

 

Parameter

Description

OfficeHours

The local office hours during which the call will be answered and assistance can be given.

AOTNumbers element

The <AOTNumbers> element will return the following sub-elements: -

Parameter

Description

International

The telephone number that should be dialled by the passengers if they are still outside of the country.

National

The telephone number that should be dialled by the passengers if they are in the country but outside of the city our office is located in.

Local

The telephone number that should be dialled by the passengers if they are within the same city that our office is located in.

OutOfOficce

The telephone number that should be dialled by the passengers only during emergency and when the office number is not available.

 

 

 

Docs Navigation