Get a flight booking

Read the full itinerary, passengers, pricing, and status of a booking at any time.

POST/Air/AirBookingData

Access requires the permission air_booking_data

Look a booking up by the UniqueId from book, or by the ClientUniqueId you set. Send at least one of the two. Use this to poll status, show the traveller their itinerary, and read the issued ticket numbers.

Path parameters

None.

Query parameters

None.

Body parameters

Name	Type	Required	Description
`SessionId`	string	Yes	Your session id.
`UniqueId`	string	One of	The booking id from book.
`ClientUniqueId`	string	One of	Your own reference from book. Send at least one of `UniqueId` or `ClientUniqueId`.

Request

curl -X POST https://api.hermeseus.com/api/Air/AirBookingData \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "UniqueId": "TP-2026-000512"
  }'

const res = await fetch("https://api.hermeseus.com/api/Air/AirBookingData", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    UniqueId: "TP-2026-000512"
  })
});

const data = await res.json();

import requests

res = requests.post(
    "https://api.hermeseus.com/api/Air/AirBookingData",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "UniqueId": "TP-2026-000512",
    },
)

data = res.json()

Response

Field	Type	Description
`Success`	boolean	`true` on success.
`UniqueId`	string	The booking id.
`ParentUniqueId`	string	Parent booking id, when the booking was re-issued.
`Category`	integer	Booking category code. `10` booked, `20` ticketed.
`Status`	integer	Booking status code. `10` booked, `20` ticketed.
`TktTimeLimit`	string	Ticketing deadline while the booking is held.
`TktTimeLimitTimeZone`	string	Timezone of `TktTimeLimit`.
`ValidatingAirlineCode`	string	Validating airline.
`TravelItinerary`	object	Itinerary, passengers, and pricing. See below.
`Error`	object	`null` on success.

TravelItinerary.ItineraryInfo object

Field	Type	Description
`ItineraryPricing`	object	`BaseFare`, `TotalTax`, `TotalFare`, `Currency`, and commission fields. All amounts are USD.
`CustomerInfoes`	array of object	Passenger details as booked.
`ReservationItems`	array of object	Flight segments, including issued ticket numbers once ticketed.
`TripDetailPtcFareBreakdowns`	array of object	Fare per passenger type.
`PhoneNumber`	string	Lead contact phone.
`Email`	string	Lead contact email.

{
  "Success": true,
  "UniqueId": "TP-2026-000512",
  "ParentUniqueId": null,
  "Category": 20,
  "Status": 20,
  "TktTimeLimit": null,
  "TktTimeLimitTimeZone": "UTC",
  "ValidatingAirlineCode": "TK",
  "TravelItinerary": {
    "ItineraryInfo": {
      "ItineraryPricing": {
        "BaseFare": 182.40,
        "TotalTax": 37.20,
        "TotalFare": 219.60,
        "Currency": "USD"
      },
      "CustomerInfoes": [
        {
          "PassengerType": 1,
          "PassengerFirstName": "Jane",
          "PassengerLastName": "Doe"
        }
      ],
      "ReservationItems": [
        {
          "DepartureAirportLocationCode": "IST",
          "ArrivalAirportLocationCode": "DXB",
          "FlightNumber": "764",
          "AirlinePNR": "ABC123",
          "TicketNumber": "235-1234567890"
        }
      ],
      "PhoneNumber": "+441234567890",
      "Email": "traveller@example.com"
    }
  },
  "Error": null
}

Errors

Code	Meaning	Fix
`Err0106002`	Neither `UniqueId` nor `ClientUniqueId` was sent.	Send at least one.
`Err0103003`	Booking not found.	Check the id.