Booking Detail Request

The Detail operation is used given a confirmed booking (included the cancelled bookings) to retrieve booking status and relevant information including but not limited to:

  • the booking status,
  • contents factsheet and,
  • if exists, specific voucher URLs.

The call can be performed in two different ways:

  • By booking reference
  • By customer reference

Request

Both operations are GET operations, so, the parameters are passed along with the URL.

The following is the specification for booking detail considering the booking and customer references. 

Specifications for booking detail

Live URLs:

https://api.hotelbeds.com/activity-api/3.0/bookings/{{LANGUAGE}}/{{BOOKING_REFRERENCE}}

https://api.hotelbeds.com/activity-api/3.0/bookings/{{LANGUAGE}}/{{CUSTOMER_REFRERENCE}}/{{HOLDER_NAME}}/{{HOLDER_SURNAME}}/{{START_DATE}}/{{END_DATE}} 

Test URLs:

https://api.test.hotelbeds.com/activity-api/3.0/bookings/{{LANGUAGE}}/{{BOOKING_REFRERENCE}}

https://api.test.hotelbeds.com/activity-api/3.0/bookings/{{LANGUAGE}}/{{CUSTOMER_REFRERENCE}}/{{HOLDER_NAME}}/{{HOLDER_SURNAME}}/{{START_DATE}}/{{END_DATE}}

Method: GET (in both cases)

Detail - Booking reference

The following is the specification for the booking detail when it’s called by passing a booking reference. 

NODE/ATTRIBUTE

TYPE

MANDATORY

DESCRIPTION

LANGUAGE

String

Y

Language code in which the response will be provided.

BOOKING_REFERENCE

String

Y

Booking reference provided after the confirmation.

Detail - Customer reference

In the case of the customer reference number (booking ID or booking number provided in the response of the Confirmation call) additional information is required to be provided. Please see below: 

NODE/ATTRIBUTE

TYPE

MANDATORY

DESCRIPTION

LANGUAGE

String

Y

Language code in which the response will be provided.

CUSTOMER_REFERENCE

String

Y

Customer reference provided in the confirmation request

HOLDER_NAME

String

Y

Holder name provided in the confirmation request

HOLDER_SURNAME

String

Y

Holder surname provided in the confirmation request

START_DATE

String

Y

Starting date provided in the confirmation request

END_DATE

String

Y

End date provided in the confirmation request

Docs Navigation