Get a booking by OTA confirmation number

This request retrieves booking details using the OTA confirmation number and channel code. The Exely booking number is not required.

Request:

GET /api/read-reservation/v1/properties/{{ property_id }}/bookings/by-external-number?externalNumber=CHAN-7852371940&channelCode=channel HTTP/1.1
Host: connect.hopenapi.com
Authorization: Bearer {{ access_token }}

Specify the property ID in property_id, the OTA booking confirmation number in externalNumber and the code of the channel through which the booking was made in channelCode. All three parameters are required. You can find the channel code in the list of channel codes.

Response:

{
  "booking": {
    "propertyId": "500360",
    "number": "20210325-500360-6987835",
    "externalNumber": "CHAN-7852371940",
    "status": "Cancelled",
    "createdDateTime": "2021-03-19T15:18:23Z",
    "modifiedDateTime": "2021-03-19T15:18:53Z",
    "guaranteeInfo": {
      "loyalty": null,
      "totalPrepaid": 0.0
    },
    "currencyCode": "EUR",
    "roomStays": [
      {
        "stayDates": {
          "arrivalDateTime": "2021-03-25T14:00",
          "departureDateTime": "2021-03-26T12:00"
        },
        "ratePlans": [
          {
            "id": "307225",
            "name": "Online"
          }
        ],
        "roomType": {
          "id": "340935",
          "name": "Standard"
        },
        "guestCount": {
          "adultCount": 1,
          "childAges": []
        },
        "guests": [],
        "dailyRates": [
          {
            "ratePlanId": "307225",
            "priceBeforeTax": 28.000,
            "date": "2021-03-25T00:00:00"
          }
        ],
        "total": {
          "priceBeforeTax": 28.0000,
          "priceAfterTax": 28.0000,
          "taxAmount": 0.0000,
          "taxes": [],
          "discounts": []
        },
        "services": [],
        "extraStayCharges": {
          "earlyArrival": null,
          "lateDeparture": null
        }
      }
    ],
    "services": [],
    "total": {
      "priceBeforeTax": 28.0000,
      "priceAfterTax": 28.0000,
      "taxAmount": 0.0000,
      "taxes": [],
      "discounts": []
    },
    "taxes": [],
    "cancellation": {
      "penaltyAmount": 0.0,
      "cancelledDateTime": "2021-03-19T15:18:53Z"
    },
    "source": {
      "type": "Channel",
      "code": "PA2"
    },
    "customer": null
  }
}

The Exely booking number is returned in the booking.number field. Additional information about the search results may be provided in warning.