← all test cases

Domestic, return, 1 adult, 1 child, 1 infant

DEL-BOM · return · 1 adult, 1 child, 1 infant · booked on hold

Domestic return for 1 adult, 1 child, 1 infant: search, reprice the cheapest fare, then the ancillaries and the seat map of the itinerary, book it on hold (no payment), read the booking details and release the hold. Two search segments. Domestic fares are sold per direction: two groups, [0] and [1]; reprice takes two items.

  1. 1 Search: 333 options
  2. 2 Reprice: 2 items
  3. 3 Ancillaries: 42 items
  4. 4 Seat map: 354 seats
  5. 5 Book on hold: 3 passengers
  6. 6 Booking details: 3 passengers
  7. 7 Release the hold: failed 409
▸2. RepricePOST /flights/reprice2 items
What this step returned: 2 items(click to expand)
  • 2 item(s) sent: option 348035e5… / price 70060236…; option a17d077f… / price d519d70c…
  • Repriced option on journey_indexes [0]: 1 flight (IX 1038 DEL-NMI); multi-flight reprice: no
  • Fare Value PARTIALLY_REFUNDABLE: adult total 3,002, net 3,002; segments[] in the reply: no (detail=journey)
  • Repriced option on journey_indexes [1]: 1 flight (IX 8006 BOM-DEL); multi-flight reprice: no
  • Fare Value PARTIALLY_REFUNDABLE: adult total 2,637, net 2,637; segments[] in the reply: no (detail=journey)
  • Price changed since search for option 348035e5…: FARE_ALERT 6,004 → 9,004
  • Price changed since search for option a17d077f…: FARE_ALERT 5,274 → 8,274
  • Booking requirements: hold allowed True, passport mandatory False, GST mandatory False, PAN applicable False, DOB adult/child/infant False/True/True
  • Price for the whole booking: total 17,278, net 17,278; itinerary_id expires at valid_till
  • 0 fare rule(s) in the reply
Request body
HTTP 200 · 14360 ms · complete request body (collapsible viewer)
{
  "items": [
    {
      "option_id": "348035e5-4322-4044-8cdd-c23ff64b6624",
      "price_id": "70060236-85cb-494f-b9b9-741c2dff9b82"
    },
    {
      "option_id": "a17d077f-71de-4e3a-9dd7-fc73497dfaa4",
      "price_id": "d519d70c-663a-4a90-8307-433fbb70c663"
    }
  ]
}
Reply
HTTP 200 · 14360 ms · complete response body (collapsible viewer)
{
  "itinerary_id": "99cae871-4739-42be-aef1-98a2349c6190",
  "valid_till": "2026-10-21T00:52:31+05:30",
  "results": [
    {
      "journey_indexes": [
        0
      ],
      "option_id": "348035e5-4322-4044-8cdd-c23ff64b6624",
      "segments": [
        {
          "segment_index": 0,
          "journey_index": 0,
          "from": "DEL",
          "to": "NMI",
          "airline_code": "IX",
          "airline_name": "Air India Express",
          "aircraft_type": "Boeing 7M8",
          "flight_number": "1038",
          "departure_time": "2026-11-20T17:40:00",
          "departure_terminal": "1",
          "arrival_time": "2026-11-20T19:45:00",
          "duration": 125
        }
      ],
      "fare": {
        "price_id": "70060236-85cb-494f-b9b9-741c2dff9b82",
        "adult": {
          "fare": {
            "base_fare": 899,
            "yq": 850,
            "airline_gst": 96,
            "booking_fee": 100,
            "other_taxes": 319,
            "total_fare": 3001.94,
            "net_fare": 3001.94,
            "pax_count": 1
          },
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          }
        },
        "child": {
          "fare": {
            "base_fare": 899,
            "yq": 850,
            "airline_gst": 96,
            "booking_fee": 100,
            "other_taxes": 319,
            "total_fare": 3001.94,
            "net_fare": 3001.94,
            "pax_count": 1
          },
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          }
        },
        "infant": {
          "fare": {
            "base_fare": 3000,
            "total_fare": 3000,
            "net_fare": 3000,
            "pax_count": 1
          },
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015"
        },
        "varies_by_segment": false
      }
    },
    {
      "journey_indexes": [
        1
      ],
      "option_id": "a17d077f-71de-4e3a-9dd7-fc73497dfaa4",
      "segments": [
        {
          "segment_index": 0,
          "journey_index": 1,
          "from": "BOM",
          "to": "DEL",
          "airline_code": "IX",
          "airline_name": "Air India Express",
          "aircraft_type": "Airbus A32N",
          "flight_number": "8006",
          "departure_time": "2026-11-25T11:30:00",
          "departure_terminal": "2",
          "arrival_time": "2026-11-25T14:00:00",
          "arrival_terminal": "3",
          "duration": 150
        }
      ],
      "fare": {
        "price_id": "d519d70c-663a-4a90-8307-433fbb70c663",
        "adult": {
          "fare": {
            "base_fare": 1001,
            "yq": 850,
            "airline_gst": 102,
            "other_taxes": 66,
            "total_fare": 2637,
            "net_fare": 2637,
            "pax_count": 1
          },
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          }
        },
        "child": {
          "fare": {
            "base_fare": 1001,
            "yq": 850,
            "airline_gst": 102,
            "other_taxes": 66,
            "total_fare": 2637,
            "net_fare": 2637,
            "pax_count": 1
          },
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          }
        },
        "infant": {
          "fare": {
            "base_fare": 3000,
            "total_fare": 3000,
            "net_fare": 3000,
            "pax_count": 1
          },
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015"
        },
        "varies_by_segment": false
      }
    }
  ],
  "booking_requirements": {
    "is_gst_mandatory": false,
    "pan_applicable": false,
    "passport_mandatory": false,
    "dob_applicable": {
      "adt": false,
      "chd": true,
      "inf": true
    },
    "is_hold": true,
    "firstname_length": 50,
    "lastname_length": 50,
    "firstname_min_length": 2,
    "lastname_min_length": 2,
    "seat_mandatory": false,
    "meal_mandatory": false,
    "baggage_mandatory": false
  },
  "price": {
    "adult": {
      "base_fare": 1900,
      "yq": 1700,
      "airline_gst": 198,
      "booking_fee": 100,
      "other_taxes": 385,
      "total_fare": 5638.94,
      "net_fare": 5638.94,
      "pax_count": 1
    },
    "child": {
      "base_fare": 1900,
      "yq": 1700,
      "airline_gst": 198,
      "booking_fee": 100,
      "other_taxes": 385,
      "total_fare": 5638.94,
      "net_fare": 5638.94,
      "pax_count": 1
    },
    "infant": {
      "base_fare": 6000,
      "total_fare": 6000,
      "net_fare": 6000,
      "pax_count": 1
    },
    "total": {
      "base_fare": 9800,
      "yq": 3400,
      "airline_gst": 396,
      "booking_fee": 200,
      "other_taxes": 770,
      "total_fare": 17277.88,
      "net_fare": 17277.88,
      "pax_count": 3
    }
  },
  "messages": [
    {
      "type": "FARE_ALERT",
      "option_id": "348035e5-4322-4044-8cdd-c23ff64b6624",
      "message": "Fare has changed: previous price 6003.88, current price 9003.88 (difference: 3000.00)",
      "old_value": 6003.88,
      "new_value": 9003.88
    },
    {
      "type": "FARE_ALERT",
      "option_id": "a17d077f-71de-4e3a-9dd7-fc73497dfaa4",
      "message": "Fare has changed: previous price 5274.00, current price 8274.00 (difference: 3000.00)",
      "old_value": 5274,
      "new_value": 8274
    }
  ]
}
Keys and what they mean
Request
keytypewhen presentimportancemeaning
items[]arrayrequired, one per groupmust readOne item per search group you chose from: one for a one way or a combined return, two for a domestic return (one per direction).
items[].option_idstringrequiredmust readThe option_id from the search reply.
items[].price_idstringrequiredmust readThe price_id of the chosen fare of that option. An option_id or price_id not in a current search answers 400 with errors[] (search again).
Total: 3 keys
Reply
keytypewhen presentimportancemeaning
itinerary_idstringalwaysmust readNames the repriced itinerary. Send it to ancillaries, seat map and book.
valid_tilldatetimealwaysmust readUntil when the itinerary_id can be booked. After it, book answers 410: reprice again.
results[]arrayalwaysmust readOne entry per item sent: journey_indexes, option_id, the flights (segments) and the one fare, priced again.
results[].segments[]arrayalwaysmust readThe flights in order, each named by (journey_index, segment_index); segment_index restarts at 0 in every journey.
results[].fareobjectalwaysmust readThe fare in the shape of search: price_id, per passenger type (adult, child, infant) the fare_ref, refundable_type, cabin_class, booking_class, fare_basis, baggage and fare, and fare_rules ids.
price.totalobjectalwaysmust readThe price in the components of search: base_fare, yq, yr, airline_gst, booking_fee, commission, other_taxes, total_fare (what the traveller pays), net_fare (what you pay us), pax_count, and the baggage stated in the fare. For the whole booking.
price.adult (child, infant)objectalways (child, infant when requested)usefulThe price in the components of search: base_fare, yq, yr, airline_gst, booking_fee, commission, other_taxes, total_fare (what the traveller pays), net_fare (what you pay us), pax_count, and the baggage stated in the fare. For one passenger of that type.
booking_requirementsobjectalwaysmust readWhat book must carry: is_gst_mandatory, pan_applicable, passport_mandatory, dob_applicable (adt, chd, inf), name lengths, and whether a seat, meal or bag is mandatory.
booking_requirements.is_holdbooleanalwaysmust readtrue when this fare may be booked on hold (book with is_hold true); false: book directly, paid at once.
fare_rulesobjectwhen knownusefulThe cancellation and date-change rules the fares point at, keyed by id (fr_1, …): bands with allowed, amount or percent, the window (from, to) and the airline's text.
messages[]arrayonly when the price changedmust readOne entry per repriced option whose price changed since search: type FARE_ALERT, option_id, old_value, new_value. Show the new price before booking.
Total: 11 keys
Errors this call answers with (6)
HTTPcodemessagedetailwhen
4019001Authentication requiredInvalid token
4005100Invalid search requestoption_id and price_id are requiredAlso 'each review item needs option_id and price_id'.
4045103Flight not foundoption_id or price_id not in a stored search.
4105102Search results have expired
5025001The airline or supplier could not complete the requestReprice failed at the airline.
5045002A supplier or service did not answer in time
Questions developers ask (2)
The price changed. What now?
messages has a FARE_ALERT with old_value and new_value for that option_id. Show the new price to the traveller before booking; the itinerary is priced at the new value.
Until when can I book?
valid_till of the reprice reply: the airline's session for this itinerary. Book before it or reprice again.
▸3. AncillariesPOST /flights/ancillaries42 items
What this step returned: 42 items(click to expand)
  • 2 flight(s) in segments[]: (journey 0, segment 0) IX 1038 DEL-NMI; (journey 1, segment 0) IX 8006 BOM-DEL
  • 20 bags (per journey): journey 0: 10 items; journey 1: 10 items
  • bags: price from 2,100 to 18,750; free items: 0
  • 22 meals (per flight): (journey 0, segment 0): 11 items; (journey 1, segment 0): 11 items
  • meals: price from 100 to 600; free items: 0
  • No other items offered on this itinerary
Request body
HTTP 200 · 149 ms · complete request body (collapsible viewer)
{
  "itinerary_id": "99cae871-4739-42be-aef1-98a2349c6190"
}
Reply
HTTP 200 · 149 ms · complete response body (collapsible viewer)
{
  "itinerary_id": "99cae871-4739-42be-aef1-98a2349c6190",
  "segments": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "airline_code": "IX",
      "flight_number": "1038",
      "from": "DEL",
      "to": "NMI"
    },
    {
      "journey_index": 1,
      "segment_index": 0,
      "airline_code": "IX",
      "flight_number": "8006",
      "from": "BOM",
      "to": "DEL"
    }
  ],
  "baggage": [
    {
      "journey_index": 0,
      "items": [
        {
          "code": "1865",
          "label": "CABIN BAGGAGE 5KGS",
          "price": 3500
        },
        {
          "code": "1866",
          "label": "CABIN BAGGAGE 3KGS",
          "price": 2100
        },
        {
          "code": "1867",
          "label": "XCESS BAGGAGE 25KG",
          "price": 18750
        },
        "… 7 more (open the viewer)"
      ]
    },
    {
      "journey_index": 1,
      "items": [
        {
          "code": "5372",
          "label": "CABIN BAGGAGE 5KGS",
          "price": 3500
        },
        {
          "code": "5373",
          "label": "CABIN BAGGAGE 3KGS",
          "price": 2100
        },
        {
          "code": "5374",
          "label": "XCESS BAGGAGE 25KG",
          "price": 18750
        },
        "… 7 more (open the viewer)"
      ]
    }
  ],
  "meal": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "items": [
        {
          "code": "3890",
          "label": "Shondesh Tiramisu",
          "price": 250
        },
        {
          "code": "3891",
          "label": "Paneer Makhani with Jeera Aloo  Vegetable Pulao",
          "price": 600
        },
        {
          "code": "3892",
          "label": "Vegetable Manchurian with Fried Rice",
          "price": 600
        },
        "… 8 more (open the viewer)"
      ]
    },
    {
      "journey_index": 1,
      "segment_index": 0,
      "items": [
        {
          "code": "9440",
          "label": "Shondesh Tiramisu",
          "price": 250
        },
        {
          "code": "9441",
          "label": "Paneer Makhani with Jeera Aloo  Vegetable Pulao",
          "price": 600
        },
        {
          "code": "9442",
          "label": "Vegetable Manchurian with Fried Rice",
          "price": 600
        },
        "… 8 more (open the viewer)"
      ]
    }
  ],
  "other": []
}
Keys and what they mean
Request
keytypewhen presentimportancemeaning
itinerary_idstringrequiredmust readThe itinerary_id from reprice. An expired one answers 404: reprice again.
Total: 1 keys
Reply
keytypewhen presentimportancemeaning
segments[]arrayalwaysusefulThe flights of the itinerary, each named by (journey_index, segment_index), with airline_code, flight_number, from and to.
baggage[]arrayalways (empty when none)must readExtra bags per journey: journey_index and items. A bag covers every flight of its journey, so it has no segment_index.
meal[]arrayalways (empty when none)must readMeals per flight: journey_index, segment_index and items.
other[]arrayalways (empty when none)usefulOther items per flight (priority check-in, bundles): journey_index, segment_index and items.
<list>[].items[]arrayalwaysmust readWhat can be bought: code (send it to book), label (show it), price (per passenger, INR).
Total: 5 keys
Errors this call answers with (4)
HTTPcodemessagedetailwhen
4019001Authentication requiredInvalid token
4005100Invalid search requestitinerary_id is requirederrors[]: field itinerary_id, rule required.
4045104Itinerary not found or expiredUnknown or expired itinerary_id.
5025001The airline or supplier could not complete the request
Questions developers ask (1)
How do I send a bag and a meal on book?
A bag with its code and journey_index; a meal, seat or other item with its code, journey_index and segment_index, exactly as this reply gave them.
▸4. Seat mapPOST /flights/seat-map354 seats
What this step returned: 354 seats(click to expand)
  • 2 flight(s) with a seat map of 2 in the itinerary: (journey 0, segment 0) Boeing 7M8, 168 seats; (journey 1, segment 0) Airbus A32N, 186 seats
  • 327 seats available of 354; free: 24; paid: 303 (from 300 to 1,700)
  • Window 107, aisle 107, middle 113; exit row 0; extra leg room 0; infant allowed 0
Request body
HTTP 200 · 5618 ms · complete request body (collapsible viewer)
{
  "itinerary_id": "99cae871-4739-42be-aef1-98a2349c6190"
}
Reply
HTTP 200 · 5618 ms · complete response body (collapsible viewer)
{
  "itinerary_id": "99cae871-4739-42be-aef1-98a2349c6190",
  "segments": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "airline_code": "IX",
      "flight_number": "1038",
      "from": "DEL",
      "to": "NMI"
    },
    {
      "journey_index": 1,
      "segment_index": 0,
      "airline_code": "IX",
      "flight_number": "8006",
      "from": "BOM",
      "to": "DEL"
    }
  ],
  "seats": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "aircraft_type": "Boeing 7M8",
      "seats": [
        {
          "aisle": false,
          "amount": 1700,
          "code": "RA0022320212078280300223447428165ABO1EI4HWT|8314",
          "column": 1,
          "desc": "3A",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": false,
          "middle": false,
          "near_wings": false,
          "reclining": false,
          "row": 8,
          "tax": 0,
          "window": true
        },
        {
          "aisle": false,
          "amount": 1700,
          "code": "RA0022320212078280300223447428165ABO1EI4HWT|8315",
          "column": 2,
          "desc": "3B",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": false,
          "middle": true,
          "near_wings": false,
          "reclining": false,
          "row": 8,
          "tax": 0,
          "window": false
        },
        {
          "aisle": true,
          "amount": 1700,
          "code": "RA0022320212078280300223447428165ABO1EI4HWT|8316",
          "column": 3,
          "desc": "3C",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": false,
          "middle": false,
          "near_wings": false,
          "reclining": false,
          "row": 8,
          "tax": 0,
          "window": false
        },
        "… 165 more (open the viewer)"
      ],
      "total_seats": 168
    },
    {
      "journey_index": 1,
      "segment_index": 0,
      "aircraft_type": "Airbus A32N",
      "seats": [
        {
          "aisle": false,
          "amount": 1700,
          "code": "RA002234994320715680022369122131WQGBSCULT20|6189",
          "column": 1,
          "desc": "1A",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": false,
          "middle": false,
          "near_wings": false,
          "reclining": false,
          "row": 8,
          "tax": 0,
          "window": true
        },
        {
          "aisle": false,
          "amount": 1700,
          "code": "RA002234994320715680022369122131WQGBSCULT20|6190",
          "column": 2,
          "desc": "1B",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": false,
          "middle": true,
          "near_wings": false,
          "reclining": false,
          "row": 8,
          "tax": 0,
          "window": false
        },
        {
          "aisle": true,
          "amount": 1700,
          "code": "RA002234994320715680022369122131WQGBSCULT20|6191",
          "column": 3,
          "desc": "1C",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": false,
          "middle": false,
          "near_wings": false,
          "reclining": false,
          "row": 8,
          "tax": 0,
          "window": false
        },
        "… 183 more (open the viewer)"
      ],
      "total_seats": 186
    }
  ]
}
Keys and what they mean
Request
keytypewhen presentimportancemeaning
itinerary_idstringrequiredmust readThe itinerary_id from reprice.
Total: 1 keys
Reply
keytypewhen presentimportancemeaning
segments[]arrayalwaysusefulThe flights of the itinerary, each named by (journey_index, segment_index), with airline_code, flight_number, from and to.
seats[]arrayalways (empty when the airline gives no map)must readOne seat map per flight: journey_index, segment_index, aircraft_type, total_seats and seats.
seats[].seats[]arrayalwaysmust readEvery seat: code (send it to book), desc (e.g. 3A, show it), row, column, amount (price; 0 = free), tax, is_available.
seats[].seats[].window / aisle / middlebooleanalwaysusefulWhere the seat is in its row.
seats[].seats[].exit_row / leg_room / infant / near_wings / recliningbooleanalwaysusefulSeat features. A passenger with an infant needs a seat with infant true; exit rows have rules of their own.
Total: 5 keys
Errors this call answers with (4)
HTTPcodemessagedetailwhen
4019001Authentication requiredInvalid token
4005100Invalid search requestitinerary_id is required
4045104Itinerary not found or expired
5025001The airline or supplier could not complete the request
▸5. Book on holdPOST /flights/book3 passengers
What this step returned: 3 passengers(click to expand)
  • Booked on hold (is_hold True) with 3 passenger(s): ADULT 1, CHILD 1, INFANT 1
  • Status ONHOLD, booking_id AIOR196466, amount 17,278, pay_till given
  • GST details sent: no; ancillaries selected: 0
Request body
HTTP 200 · 16700 ms · complete request body (collapsible viewer)
{
  "itinerary_id": "99cae871-4739-42be-aef1-98a2349c6190",
  "is_hold": true,
  "pax_details": [
    {
      "first_name": "Rohan",
      "last_name": "Nair",
      "pax_type": "ADULT",
      "title": "Mr",
      "gender": "male",
      "dob": "1990-05-12",
      "phone": "9876543210",
      "email": "rohan.verma@example.com"
    },
    {
      "first_name": "Anya",
      "last_name": "Nair",
      "pax_type": "CHILD",
      "title": "Miss",
      "gender": "female",
      "dob": "2018-10-21",
      "phone": "9876543210",
      "email": "rohan.verma@example.com"
    },
    {
      "first_name": "Vihaan",
      "last_name": "Nair",
      "pax_type": "INFANT",
      "title": "Master",
      "gender": "male",
      "dob": "2026-02-23",
      "phone": "9876543210",
      "email": "rohan.verma@example.com"
    }
  ]
}
Reply
HTTP 200 · 16700 ms · complete response body (collapsible viewer)
{
  "booking_id": "AIOR196466",
  "itinerary_id": "99cae871-4739-42be-aef1-98a2349c6190",
  "status": "ONHOLD",
  "amount": 17277.88,
  "pay_till": "2026-10-21T03:22:00Z"
}
Keys and what they mean
Request
keytypewhen presentimportancemeaning
itinerary_idstringrequiredmust readThe itinerary_id from reprice, before its valid_till.
is_holdbooleanoptional, default falsemust readfalse: book directly, paid at once from your balance or credit and ticketed. true: hold the seats without payment until pay_till (only when reprice said booking_requirements.is_hold true); then confirm-hold or release.
pax_details[]arrayrequired, one per passengermust readEvery passenger of the search, adults first: first_name, last_name, pax_type (ADULT, CHILD, INFANT), title, gender, dob, phone and email.
pax_details[].passport_detailsobjectwhen reprice says passport_mandatoryusefulpassport_number, passport_issue_date, passport_expiry_date, passport_issue_country, nationality.
pax_details[].ancillariesobjectoptionalusefulWhat this passenger buys: seat[], meal[], other[] (each with code, price, label, journey_index and segment_index) and baggage[] (code, price, label, journey_index; no segment_index). Codes come from ancillaries and seat map; an item on a flight not in the itinerary answers 400 with errors[] (rule scope).
gst_detailsobjectoptional; required when reprice says is_gst_mandatoryusefulThe company on the invoice: name, number (GSTIN), address, email, mobile.
Total: 6 keys
Reply
keytypewhen presentimportancemeaning
booking_idstringalwaysmust readYour booking's id. Send it to booking details, confirm-hold and release.
statusstringalwaysmust readONHOLD (held, pay before pay_till), SUCCESS (booked directly and paid), PENDING (the airline has not confirmed yet: read the booking details), or the booking's state.
pay_tilldatetimeon a holdmust readUntil when the hold can be confirmed; after it the airline releases the seats.
amountnumberalwaysmust readWhat the booking costs (INR); taken at once for a direct booking, at confirm-hold for a hold.
itinerary_idstringalwaysinformationalThe itinerary that was booked.
Total: 5 keys
Errors this call answers with (7)
HTTPcodemessagedetailwhen
4019001Authentication requiredInvalid token
4039002You do not have permission for this actionRole without bookings.create (Finance, Operation, Tech).
4003000Invalid request(the API's detail text)
4009003Some fields are missing or invalidSchema validation of the body (required fields, formats); errors[] lists them.
5033003A service the API depends on is unavailable(the API's text)the API answered 5xx or did not answer.
4093101Hold booking limit reached
5009000Something went wrongPayment or order errors that no translator knows.
Questions developers ask (2)
Is gst_details required?
Only when booking_requirements.is_gst_mandatory is true. When you send it, all five fields are required.
What is the difference between is_hold true and false?
false pays from your wallet and tickets at once. true holds the seats without payment until pay_till; confirm with confirm-hold or give them back with release.
▸6. Booking detailsPOST /flights/booking/details3 passengers
What this step returned: 3 passengers(click to expand)
  • Status ONHOLD, payment PENDING, route DOMESTIC, pay_till given
  • Journey 0 DEL-NMI: segment 0 IX 1038 DEL-NMI
  • passenger 0 ADULT Rohan: CONFIRMED, PNR U68PXD, ticket BX21HJ00051-1, fare Value X/XNRA015, total 3,002, net 3,002, baggage hand 7kg, checkin 15kg
  • passenger 1 CHILD Anya: CONFIRMED, PNR U68PXD, ticket BX21HJ00051-2, fare Value X/XNRA015, total 3,002, net 3,002, baggage hand 7kg, checkin 15kg
  • passenger 2 INFANT Vihaan: CONFIRMED, PNR U68PXD, ticket BX21HJ00051-3, fare Value X/XNRA015, total 3,000, net 3,000, baggage not stated
  • Journey 1 BOM-DEL: segment 0 IX 8006 BOM-DEL
  • passenger 0 ADULT Rohan: CONFIRMED, PNR W8766K, ticket BX21HJ00061-1, fare Value X/XNRA015, total 2,637, net 2,637, baggage hand 7kg, checkin 15kg
  • passenger 1 CHILD Anya: CONFIRMED, PNR W8766K, ticket BX21HJ00061-2, fare Value X/XNRA015, total 2,637, net 2,637, baggage hand 7kg, checkin 15kg
  • passenger 2 INFANT Vihaan: CONFIRMED, PNR W8766K, ticket BX21HJ00061-3, fare Value X/XNRA015, total 3,000, net 3,000, baggage not stated
  • PNR on 6 of 6 passenger-journeys; 3 passenger(s): ADULT Rohan Nair, CHILD Anya Nair, INFANT Vihaan Nair
  • Booking price: base 9,800, yq 3,400, other taxes 770, total 17,278, net 17,278
Request body
HTTP 200 · 3178 ms · complete request body (collapsible viewer)
{
  "booking_id": "AIOR196466"
}
Reply
HTTP 200 · 3178 ms · complete response body (collapsible viewer)
{
  "booking_id": "AIOR196466",
  "status": "ONHOLD",
  "payment_status": "PENDING",
  "created_at": "2026-10-21T00:22:37Z",
  "pay_till": "2026-10-21T03:22:00Z",
  "route_type": "DOMESTIC",
  "journeys": [
    {
      "journey_index": 0,
      "from": "DEL",
      "to": "NMI",
      "departure_time": "2026-11-20T17:40",
      "arrival_time": "2026-11-20T19:45",
      "segments": [
        {
          "segment_index": 0,
          "from": "DEL",
          "to": "NMI",
          "airline_code": "IX",
          "airline_name": "Air India Express",
          "flight_number": "1038",
          "departure_time": "2026-11-20T17:40",
          "arrival_time": "2026-11-20T19:45",
          "departure_terminal": "1",
          "duration": 125
        }
      ],
      "passengers": [
        {
          "passenger_index": 0,
          "first_name": "Rohan",
          "last_name": "Nair",
          "pax_type": "ADULT",
          "title": "Mr",
          "gender": "male",
          "dob": "1990-05-12",
          "fare": {
            "base_fare": 899,
            "yq": 850,
            "airline_gst": 96,
            "booking_fee": 100,
            "other_taxes": 319,
            "total_fare": 3001.94,
            "net_fare": 3001.94
          },
          "status": "CONFIRMED",
          "pnr": "U68PXD",
          "ticket_number": "BX21HJ00051-1",
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          }
        },
        {
          "passenger_index": 1,
          "first_name": "Anya",
          "last_name": "Nair",
          "pax_type": "CHILD",
          "title": "Miss",
          "gender": "female",
          "dob": "2018-10-21",
          "fare": {
            "base_fare": 899,
            "yq": 850,
            "airline_gst": 96,
            "booking_fee": 100,
            "other_taxes": 319,
            "total_fare": 3001.94,
            "net_fare": 3001.94
          },
          "status": "CONFIRMED",
          "pnr": "U68PXD",
          "ticket_number": "BX21HJ00051-2",
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          }
        },
        {
          "passenger_index": 2,
          "first_name": "Vihaan",
          "last_name": "Nair",
          "pax_type": "INFANT",
          "title": "Master",
          "gender": "male",
          "dob": "2026-02-23",
          "fare": {
            "base_fare": 3000,
            "total_fare": 3000,
            "net_fare": 3000
          },
          "status": "CONFIRMED",
          "pnr": "U68PXD",
          "ticket_number": "BX21HJ00051-3",
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015"
        }
      ]
    },
    {
      "journey_index": 1,
      "from": "BOM",
      "to": "DEL",
      "departure_time": "2026-11-25T11:30",
      "arrival_time": "2026-11-25T14:00",
      "segments": [
        {
          "segment_index": 0,
          "from": "BOM",
          "to": "DEL",
          "airline_code": "IX",
          "airline_name": "Air India Express",
          "flight_number": "8006",
          "departure_time": "2026-11-25T11:30",
          "arrival_time": "2026-11-25T14:00",
          "departure_terminal": "2",
          "arrival_terminal": "3",
          "duration": 150
        }
      ],
      "passengers": [
        {
          "passenger_index": 0,
          "first_name": "Rohan",
          "last_name": "Nair",
          "pax_type": "ADULT",
          "title": "Mr",
          "gender": "male",
          "dob": "1990-05-12",
          "fare": {
            "base_fare": 1001,
            "yq": 850,
            "airline_gst": 102,
            "booking_fee": 100,
            "other_taxes": 66,
            "total_fare": 2637,
            "net_fare": 2637
          },
          "status": "CONFIRMED",
          "pnr": "W8766K",
          "ticket_number": "BX21HJ00061-1",
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          }
        },
        {
          "passenger_index": 1,
          "first_name": "Anya",
          "last_name": "Nair",
          "pax_type": "CHILD",
          "title": "Miss",
          "gender": "female",
          "dob": "2018-10-21",
          "fare": {
            "base_fare": 1001,
            "yq": 850,
            "airline_gst": 102,
            "booking_fee": 100,
            "other_taxes": 66,
            "total_fare": 2637,
            "net_fare": 2637
          },
          "status": "CONFIRMED",
          "pnr": "W8766K",
          "ticket_number": "BX21HJ00061-2",
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          }
        },
        {
          "passenger_index": 2,
          "first_name": "Vihaan",
          "last_name": "Nair",
          "pax_type": "INFANT",
          "title": "Master",
          "gender": "male",
          "dob": "2026-02-23",
          "fare": {
            "base_fare": 3000,
            "total_fare": 3000,
            "net_fare": 3000
          },
          "status": "CONFIRMED",
          "pnr": "W8766K",
          "ticket_number": "BX21HJ00061-3",
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015"
        }
      ]
    }
  ],
  "price": {
    "base_fare": 9800,
    "yq": 3400,
    "airline_gst": 396,
    "booking_fee": 400,
    "other_taxes": 770,
    "agent_markup": 200,
    "total_fare": 17277.88,
    "net_fare": 17277.88
  }
}
Keys and what they mean
Request
keytypewhen presentimportancemeaning
booking_idstringrequiredmust readThe id book returned.
Total: 1 keys
Reply
keytypewhen presentimportancemeaning
statusstringalwaysmust readThe booking's state: CREATED, ONHOLD, SUCCESS, PNR_RELEASED, CANCELLED, FAILED.
payment_statusstringalwaysmust readPENDING until paid, then SUCCESS; FAILED or REFUNDED later.
pay_tilldatetimeon a holdmust readUntil when a held booking can be confirmed; after it the airline releases the seats.
journeys[]arrayalwaysmust readThe booking journey by journey: its dates, its flights and, for every passenger on it, who they are, their state, the PNR, the ticket, the fare paid for that journey and the add-ons.
journeys[].passengers[].pnrstringonce the airline confirmedmust readThe airline's record locator for this passenger on this journey. Empty until the hold or the ticket is confirmed.
journeys[].passengers[].statusstringalwaysmust readPENDING until confirmed, then CONFIRMED; CANCELLED, VOIDED or REISSUED when something happened to this passenger on this journey.
priceobjectalwaysmust readThe booking's price as a whole, in the components of the search price (base_fare, yq, yr, airline_gst, booking_fee, commission, other_taxes, total_fare, net_fare) plus ancillaries and fees.
journeys[].passengers[].fareobjectalwaysmust readWhat this passenger's journey cost, in the components of the search price plus ancillaries bought on it.
Total: 8 keys
Errors this call answers with (4)
HTTPcodemessagedetailwhen
4019001Authentication requiredInvalid token
4039002You do not have permission for this actionRole without bookings.read.
4003000Invalid requestBooking_id is required
4049005Not foundBooking not found
Questions developers ask (1)
Why is pnr empty?
The airline has not confirmed yet: the passenger reads PENDING. It appears once the hold or the ticket is confirmed.
▸7. Release the holdPOST /flights/booking/releasefailed 409
What this step returned(click to expand)
  • Failed with HTTP 409: The hold could not be released; the PNR is still held
  • This reply is the sample: later steps of the case were not called with it.
Request body
HTTP 409 · 3939 ms · complete request body (collapsible viewer)
{
  "booking_id": "AIOR196466"
}
Reply (failed, HTTP 409)
HTTP 409 · 3939 ms · complete response body (collapsible viewer)
{
  "code": 3105,
  "message": "The hold could not be released; the PNR is still held",
  "traceId": "89666e303b0bc0e52097ada801513f66"
}
Keys and what they mean
Request
keytypewhen presentimportancemeaning
booking_idstringrequiredmust readA booking on hold. A booking that is not on hold answers an error.
Total: 1 keys
Reply
keytypewhen presentimportancemeaning
statusstringalwaysmust readPNR_RELEASED when the airline freed the seats. A release the airline refuses answers 409 (code 3105): the PNR is still held, try again later.
pnrstringalwaysusefulThe record locator that was released.
booking_idstringalwaysinformationalThe booking released.
Total: 3 keys
Errors this call answers with (5)
HTTPcodemessagedetailwhen
4019001Authentication requiredInvalid token
4039002You do not have permission for this actionRole without bookings.cancel.
4003000Invalid requestBooking_id is required
4049005Not foundBooking not found
4093102Booking is not pendingTicketed or already released.
Questions developers ask (1)
Release answered 409 3105. Is the booking released?
No. The airline did not give the PNR back; it stays held until pay_till. Try again later.