Holiday Extras API

Book FastTrack

FastTrack Booking Request

Method

POST

Endpoint

The endpoint to use is:

https://api.holidayextras.co.uk/v1/fastTrack/FastTrackCode

For example, for FastTrack Terminal 1 at Manchester airport the endpoint is:

https://api.holidayextras.co.uk/v1/fastTrack/APMANSF1

Request Parameters

The parameters must be sent in the body of the request, as x-www-form-urlencoded data.

NB: All parameter names are case sensitive.

Name Data Type Format Mandatory? Additional Information
ABTANumber String [A-Z0-9] 5 chars Y This is also known as an ‘agent code’.
This will be confirmed to you by your Account Manager during set up.
Password String [A-Z0-9] 5 chars N* Password required for retail agent requests - intermediaries do not require a password.
This will be confirmed to you by your Account Manager during set up.
Initials String [A-Z] 3 chars N The initials of the Operator / Agent.
key String [A-Z] Y This will be assigned to you by your Account Manager during set up.
token String [0-9] 9 chars Y This is the same token used in the availability request.
ArrivalDate Date YYYY-MM-DD Y Date customer wishes to enter the fasttrack.
ArrivalTime Time HHMM Y Time customer wishes to enter the fasttrack.
Adults Integer [0-4] 1 char Y Number of adults requiring entry to the fasttrack.
Children Integer [0-3] 1 char N Number of children requiring entry to the fasttrack.
Infants Integer 1 char Y Number of infants requiring entry to the fasttrack.
Title String [A-Z] 4 chars Y Title of lead passenger
Initial String [A-Z] 1 chars Y Initial of lead passenger
Surname String [A-Z] 20 chars Y Surname of lead passenger
Address[] String [A-Z0-9] 25 chars Y First line of address (house name / number and road) of lead passenger
If you require more than 1 address line, then you can replicate this field and increment the number in square brackets, i.e. “Address[1]” for address line 2, and so on.
NB: This field can be set to NA
Town String [A-Z] 20 chars Y Town of address
NB: This field can be set to NA
County String [A-Z] 20 chars Y County of address
NB: This field can be set to NA
PostCode String [A-Z0-9] 10 chars Y Post code of address
NB: This field can be set to NA
Email String [A-Z0-9] 50 chars Y Email of lead passenger
MobileNum String [0-9] 20 char Y Mobile phone number of lead passenger.
PriceCheckFlag String Y Y Indicates a price check will be carried out prior to booking.
If the price is lower in the system the booking will be made as the customer will benefit from a saving. If the price has changed and is higher than the price stated on availability, an error will return to explain that the price has increased, the booking can still be made but the customer must confirm that they will pay the higher amount. You should then resubmit the request changing the PriceCheckPrice with the new price.
PriceCheckPrice Float [0-9] 8 chars Y Price of the product, received from the availability request or price check.
System String [A-Z] 3 chars Y* For European products, you need to pass in the value of System=ABG (the default is System=ABC, which is UK products only).
Waiver Boolean [0,1] Y Defaults to 0 if not supplied.  

Payment

In the UK, we are PCI DSS compliant and so we do not accept customers’ payment details being passed to us via the API. Further details can be found in our section on Payment.

Please contact your Account Manager if you have any questions concerning payment.

FastTrack Booking Response

The fasttrack booking response will confirm that a booking has been placed in our system.

For a detailed explanation of the fields returned, please see below:

Field Additional Information
Booking/BookingRef This is the reference for this booking. It must be referred to in all communication with us concerning this booking.
NB: Our booking references are up to 12 char alphanumeric (including 1/I and 0/O/Q).
Booking/AgentComm Commission you have earned from this booking.
Booking/MoreInfoURL The URL for viewing the booking. See view booking for more details.
API_Header/Request A list of parameters that were sent in the booking request.

Booking Confirmation

We expect partners to create their own booking confirmations to send to customers, using the information provided in the booking response .

Worked Examples

Below are worked examples of both the request and response for booking a fasttrack.

UK Products Booking Request

https://api.holidayextras.co.uk/v1/fastTrack/APMANSF11
    <Request>
        <ABTANumber>YourABTANumber</ABTANumber>
        <Password>YourPassword</Password>
        <Initials>YourInitials</Initials>
        <key>YourKey</key>
        <token>YourToken</token>
        <ArrivalDate>2018-12-01</ArrivalDate>
        <ArrivalTime>1200</ArrivalTime>
        <Adults>2</Adults>
        <Children>0</Children>
        <Infants>0</Infants>
        <Title>MR</Title>
        <Initial>T</Initial>
        <Surname>TEST</Surname>
        <Address>123 Test Street</Address>
        <Town>Testville</Town>
        <County>Testshire</County>
        <PostCode>TE12 3ST</PostCode>
        <Email>test@test.com</Email>
        <MobileNum>01234567890</MobileNum>
        <PriceCheckFlag>Y</PriceCheckFlag>
        <PriceCheckPrice>70.00</PriceCheckPrice>
    </Request>

UK Products Booking Response

<?xml version="1.0"?>
<API_Reply Product="FastTrack" RequestCode="5" Result="OK">
  <Booking>
    <BookingRef>APBBFKBX</BookingRef>
    <AgentComm>1.25</AgentComm>
    <VATonComm>0.21</VATonComm>
    <MoreInfoURL>v1/booking/APBBFKBX</MoreInfoURL>
    <EmailConfirmationAttachments>
      <name>Fast Track Voucher</name>
      <source>https://voucher-staging.holidayextras.co.uk/voucher/fastTrack?email=dimitar.kod%40gmail.com&booking_ref=APBBFKBX&agent=TESTX&productType=fastTrack&productCode=MANSF1</source>
      <type>text/html</type>
    </EmailConfirmationAttachments>
  </Booking>
  <API_Header>
    <Request>
      <ABTANumber>YourABTANumber</ABTANumber>
      <Password>YourPassword</Password>
      <key>YourKey</key>
      <token>YourToken</token>
      <Initials>YourInitials</Initials>
      <ArrivalDate>2018-12-01</ArrivalDate>
      <ArrivalTime>1200</ArrivalTime>
      <Adults>2</Adults>
      <Children>0</Children>
      <Infants>0</Infants>
      <Title>Mr</Title>
      <Initial>T</Initial>
      <Surname>TEST</Surname>
      <Address>123 Test Street</Address>
      <Town>Testville</Town>
      <County>Testshire</County>
      <PostCode>TE12 3ST</PostCode>
      <Email>test@test.com</Email>
      <MobileNum>01234567890</MobileNum>
      <PriceCheckFlag>Y</PriceCheckFlag>
      <PriceCheckPrice>70.00</PriceCheckPrice>
      <v>1</v>
    </Request>
  </API_Header>
</API_Reply>