How to Retrieve Flight Booking Details
Use the get booking endpoint to retrieve the full details of an existing booking, including flight segments, traveler information, pricing, and current status.
Endpoint
GET /flights/api/v2/bookings?bookingid={bookingid}
Headers
| Header | Required | Description |
|---|
x-api-key | Yes | Your API key. |
x-correlation-id | Yes | Correlation ID from the autocomplete response. |
Query Parameters
| Parameter | Type | Required | Description |
|---|
booking_id | string | Yes | The booking ID returned when the booking was created. |
Example Request
GET /flights/api/v2/bookings?booking_id=XNFiEtVA3LL
Example Response
JSON
{
"status": "success",
"data": {
"travel_date": "2026-04-15",
"booking_id": "XNFiEtVA3LL",
"airline_pnr": "ABC123",
"booking_status": "TICKETED",
"trip_type": "Oneway",
"flight_segments": [
{
"flight_number": "UA123",
"airline": "United Airlines",
"origin": "SFO",
"originairportname": "San Francisco International Airport",
"destination": "FRA",
"destinationairportname": "Frankfurt Airport",
"departure_time": "2026-04-15T10:30:00",
"arrival_time": "2026-04-16T06:45:00",
"duration": "12h 15m",
"cabin_class": "Economy",
"status": "CONFIRMED"
},
{
"flight_number": "LH456",
"airline": "Lufthansa",
"origin": "FRA",
"originairportname": "Frankfurt Airport",
"destination": "BLR",
"destinationairportname": "Kempegowda International Airport",
"departure_time": "2026-04-16T09:00:00",
"arrival_time": "2026-04-16T22:30:00",
"duration": "9h 0m",
"cabin_class": "Economy",
"status": "CONFIRMED"
}
],
"traveller_details": [
{
"type": "ADULT",
"title": "Mr",
"first_name": "John",
"last_name": "Smith",
"dateofbirth": "1985-06-15",
"ticket_number": "0161234567890"
},
{
"type": "CHILD",
"title": "Miss",
"first_name": "Emma",
"last_name": "Smith",
"dateofbirth": "2018-03-22",
"ticket_number": "0169876543210"
}
],
"pricing": {
"base_price": 900,
"taxandfees": 171,
"total_price": 1071,
"currency_code": "USD"
},
"tickettimelimit": "2026-04-14T23:59:00Z"
},
"message": "Booking details retrieved successfully"
}
Response Fields
Booking Information
| Field | Type | Description |
|---|
traveldate | string | Primary travel date (YYYY-MM-DD). |
bookingid | string | Xeni booking identifier. |
airlinepnr | string | Airline PNR (Passenger Name Record) / confirmation code. Share this with travelers for airline check-in. |
bookingstatus | string | Current booking status. See status reference below. |
triptype | string | "Oneway" or "Return". |
tickettime_limit | string | Deadline to confirm the booking (ISO 8601). Only relevant for BOOKED status. |
Flight Segments
| Field | Type | Description |
|---|
flightnumber | string | Airline flight number. |
airline | string | Operating airline. |
origin / destination | string | IATA airport codes. |
originairportname / destinationairportname | string | Full airport names. |
departuretime / arrivaltime | string | ISO 8601 timestamps. |
duration | string | Segment flight duration. |
cabinclass | string | Cabin class for this segment. |
status | string | Segment status (e.g., CONFIRMED, CANCELLED). |
Traveller Details
| Field | Type | Description |
|---|
type | string | Passenger type (ADULT, CHILD, INFANT). |
title | string | Title (Mr, Mrs, Ms, Miss). |
firstname / lastname | string | Traveler name. |
dateofbirth | string | Date of birth (YYYY-MM-DD). |
ticket_number | string | Issued ticket number (present when status is TICKETED). |
Pricing
| Field | Type | Description |
|---|
baseprice | number | Base fare before taxes (total for all passengers). |
taxandfees | number | Total taxes and fees. |
totalprice | number | Final total price. |
currency_code | string | Currency of the pricing. |
Booking Status Reference
| Status | Description |
|---|
BOOKED | Reservation is held. Confirm before the ticket time limit. |
TICKETED | Tickets have been issued. |
TICKETINPROCESS | Ticketing is being processed. |
CANCELLED | Booking has been cancelled. |
Use Cases
- Display booking confirmation — Show travelers their itinerary, PNR, and ticket numbers after booking.
- Check ticketing status — Poll this endpoint after confirmation to verify that ticketing has completed (if the confirm response returned
TICKETINPROCESS). - Pre-cancellation review — Retrieve booking details to display the itinerary and pricing before the user confirms cancellation.
Related Articles
