REST operation

The Reconfirmations REST operation allows to retrieve the reconfirmation numbers (The confirmation number of the Hotel, both for the Hotelbeds product and for that of external suppliers product) of the bookings made by the client when requested in a GET call to our endpoint.

The Reconfirmations operation offers a wide variety of filters to help narrowing down reconfirmation number results. Only one filter can be used at the same time. Below the four possible filters you can use:

  • between two cheking dates
  • between two reconfirmation dates
  • list of clientReference ids
  • list of booking Ids

Reconfirmations Request

Endpoint

GET https://api.test.hotelbeds.com/hotel-api/1.0/bookings/reconfirmations?from={{from}} &to={{to}} &start={{start}} &end={{end}} &filterType={{filterType}} &clientReferences={{clientReferences}} &references={{references}}
TIMEOUT: 120 seconds

 

Request parameters

Parameter

Type

Mandatory

Description

from

Int

Y

Lowest value of the range of bookings with supplierConfirmationCodes to be returned (as in a paginated response).

to

Int

Y

Highest value of the range of bookings with supplierConfirmationCodes to be returned (as in a paginated response).

start

Date

N

Date from when the method will start checking reconfirmation numbers. The format must be YYYY-MM-DD. In case of using 'start' and 'end' parameters, the use of 'filterType' parameter is mandatory.

end

Date

N

Date to when the method will finish checking reconfirmation numbers. The format must be YYYY-MM-DD. In case of using 'start' and 'end' parameters, the use of 'filterType' parameter is mandatory.

filterType

String

N

The parameter is used to identify if the reconfirmation numbers is by check-in date or by reconfirmation date.

Values:

  • CHECKIN: for the check-in date.
  • RECONFIRMATION: for the reconfirmation date the booking was included in Hotelbeds systems.

In case of using 'filterType' parameters, the use of 'start' and 'end' parameters is mandatory.

clientReferences

String

N

Parameter to filter the results by the booking reference in client API side.Can include multiple values separated by ",". Max 80 values.

references

String

N

Parameter to filter the results by the booking reference in Hotelbeds side.Can include multiple values separated by ",". Max 80 values.

Request Example

https://api.test.hotelbeds.com/hotel-api/1.0/bookings/reconfirmations?from=1&to=100&start=2020-01-10&end=2020-01-15&filterType=CHECKIN

Request Example

https://api.test.hotelbeds.com/hotel-api/1.0/bookings/reconfirmations?from=1&to=2&clientReferences=XX270220113856831889,XX270220113856831889

Request Example

https://api.test.hotelbeds.com/hotel-api/1.0/bookings/reconfirmations?from=1&to=100&start=2020-04-01&end=2020-04-07&filterType=RECONFIRMATION

Request Example

https://api.test.hotelbeds.com/hotel-api/1.0/bookings/reconfirmations?from=1&to=100&references=77-1322905,77-1322904

 

Reconfirmations Response

The response of Reconfirmations provides key information of the booking (but no all the info from Booking response). The main info included is:

  • booking reference
  • client reference
  • room code
  • supplierConfirmationCode

 

Response JSON Example

{
  "auditData": {
    "processTime": "2125",
    "timestamp": "2020-02-12 08:43:59.876",
    "requestHost": "0:0:0:0:0:0:0:1",
    "serverId": "PMI-L-7RDKRV2#A+",
    "environment": "[local, awseuwest1]",
    "release": "97aaaf050e97f38dba4b0be9075523e501bf3dc7",
    "token": "87AB1EF792B8415F8FAE352076795DF3",
    "internal": "null||||0|0||||||||||||0|||0|0||0|null|||"
  },
  "bookings": [
    {
      "reference": "1-3423498",
      "clientReference": "R3342223421",
      "hotel": {
        "rooms": [
          {
            "id": 10,
            "code": "DBL.ST",
            "supplierConfirmationCode": [
              "HIL_Conf_444322"
            ]
          }
        ]
      }
    },
    {
      "reference": "1-3423499",
      "clientReference": "R3342223425",
      "hotel": {
        "rooms": [
          {
            "id": 10,
            "code": "DBL.ST",
            "supplierConfirmationCode": [
              "HIL_Conf_444322"
            ]
          }
        ]
      }
    }
  ]
}

Docs Navigation