Booking Details API

The Booking Details API allows you to retrieve comprehensive information about a flight booking using either a booking ID or trace ID. This API returns detailed booking information including passenger details, flight segments, fare breakdown, and booking policies.

Endpoint

POST /flight/fetch_bookings

Authentication

Include the following headers in your request:

client-id: Your unique client identifier
client-secret: Your secure client secret key
Content-Type: application/json

Request Parameters

You can retrieve booking details using either of these request formats:

Option 1: Using Booking ID

{
  "client_referenceId": "string",
  "booking_id": "integer"
}

Option 2: Using Trace ID

{
  "client_referenceId": "string",
  "trace_id": "string"
}

Parameter	Type	Required	Description
`client_referenceId`	string	Yes	Unique client reference identifier
`booking_id`	integer	No*	Unique booking identifier
`trace_id`	string	No*	Unique trace identifier from booking process

*Either booking_id OR trace_id must be provided.

Example Request

{
    "trace_id": "677e0e8c-69f6-4480-b3c8-b89308f1b0bd",
    "client_referenceId": "YUOP7888777978736"
}

Response Structure

Success Response (200 OK)

{
    "status": "SUCCESS",
    "status_code": "200",
    "message": "Booking Details retrieved successfully.",
    "data": {
        "trace_id": "677e0e8c-69f6-4480-b3c8-b89308f1b0bd",
        "result": {
            "pnr": "I2JMRK",
            "booking_id": 1984869,
            "seats_booked": false,
            "journey_type": "OneWay",
            "domestic": true,
            "source": "Indigo",
            "origin": "DEL",
            "destination": "BOM",
            "airline_code": "6E",
            "airline_remark": "6E main",
            "airline_tollfree_no": "1800-0001-5456-51515",
            "last_ticket_date": "2025-05-24 11:12:08",
            "is_lcc": true,
            "non_refundable": false,
            "coupon_applicable": null,
            "fare_type": "RegularFare",
            "credit_note_no": null,
            "segments": [...],
            "passengers": [...],
            "fare": {...},
            "fare_rules": [...],
            "mini_fare_rules": [...],
            "cancellation_charges": null,
            "penalty_charges": {...}
        }
    }
}

Response Fields Explanation

Booking Information

pnr: Passenger Name Record - unique airline booking reference
booking_id: Internal system booking identifier
journey_type: Type of journey (OneWay, Return, Multi-trip)
domestic: Boolean indicating if flight is domestic
source: Airline source system
airline_code: IATA airline code
is_lcc: Boolean indicating if it's a Low Cost Carrier

Flight Segments

Each booking contains flight segments with detailed information:

"segments": [
    {
        "trip_indicator": "outbound",
        "flight_number": "675",
        "airline_code": "6E",
        "airline_name": "IndiGo",
        "fare_class": "QR",
        "origin": {
            "airport_code": "DEL",
            "airport_name": "Indira Gandhi Airport",
            "terminal": "1D",
            "city_name": "Delhi",
            "departure_time": "2025-06-05 08:00:00"
        },
        "destination": {
            "airport_code": "BOM",
            "airport_name": "Chhatrapati Shivaji International Airport",
            "terminal": "2",
            "city_name": "Mumbai",
            "arrival_time": "2025-06-05 10:10:00"
        },
        "duration": "2h 10m",
        "flight_status": "Confirmed"
    }
]

Passenger Information

Comprehensive passenger details including personal information, ticket details, and additional services:

"passengers": [
    {
        "passenger_id": 3223416,
        "title": "Mr",
        "fname": "John",
        "lname": "Doe",
        "passenger_type": "adult",
        "is_lead_passenger": true,
        "dob": "1985-05-10",
        "gender": "M",
        "mobile": "8973674563",
        "email": "john.doe@example.com",
        "fare": {
            "currency": "INR",
            "basefare": 5180,
            "tax_and_surcharges": 841,
            "total_fare": 7171,
            "total_baggage_charges": 0,
            "total_meal_charges": 400,
            "total_seat_charges": 750
        },
        "ticket": {
            "ticket_number": "I2JMRK",
            "issue_date": "2025-05-24 10:47:09",
            "status": "OK"
        },
        "baggage": [...],
        "meal": [...],
        "seat": [...]
    }
]

Additional Services

Baggage Information

"baggage": [
    {
        "code": "NoBaggage",
        "desc": "Purchase",
        "weight": 0,
        "price": 0,
        "currency": "INR",
        "origin": "DEL",
        "destination": "BOM"
    }
]

Meal Information

"meal": [
    {
        "code": "VGML",
        "desc": "Direct",
        "airline_desc": "Veg Meal",
        "quantity": 1,
        "price": 400,
        "currency": "INR"
    }
]

Seat Information

"seat": [
    {
        "code": "6F",
        "row_no": "6",
        "seat_no": "F",
        "seat_type": "Window",
        "craft_type": "A321-220",
        "price": 750,
        "currency": "INR"
    }
]

Fare Rules and Policies

Detailed Fare Rules

"fare_rules": [
    {
        "origin": "DEL",
        "destination": "BOM",
        "airline": "6E",
        "fare_rules": "The FareBasisCode is: Q0IP<br />Temp Fare Rules GG<br/> ..."
    }
]

Mini Fare Rules (Cancellation & Change Policies)

"mini_fare_rules": [
    {
        "journey_points": "DEL-BOM",
        "type": "Reissue",
        "from": "0",
        "to": "3",
        "unit": "DAYS",
        "charges": "INR 2999",
        "online_reissue_allowed": false,
        "online_refund_allowed": false
    },
    {
        "journey_points": "DEL-BOM",
        "type": "Cancellation",
        "from": "0",
        "to": "3",
        "unit": "DAYS",
        "charges": "INR 3999",
        "online_reissue_allowed": false,
        "online_refund_allowed": false
    }
]

Use Cases

Booking Confirmation: Retrieve complete booking details for confirmation emails
Check-in Process: Access passenger and flight information for check-in
Customer Service: Provide comprehensive booking information to customers
Policy Reference: Check cancellation and change policies
Fare Analysis: Review detailed fare breakdown and additional charges

Error Handling

The API returns appropriate error responses for invalid requests:

400 Bad Request: Invalid parameters or missing required fields
404 Not Found: Booking not found with provided ID/trace ID
401 Unauthorized: Invalid authentication credentials