Domestic, one way, 1 adult
DEL-BOM · one way · 1 adult · booked on hold
Domestic one way for 1 adult: 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. One search segment; one group, journey_indexes [0]; reprice takes one item.
- 1 Search: 262 options
- 2 Reprice: 1 items
- 3 Ancillaries: 21 items
- 4 Seat map: 168 seats
- 5 Book on hold: 1 passengers
- 6 Booking details: 1 passengers
- 7 Release the hold: failed 409
▸1. SearchPOST /flights/search262 options
What this step returned: 262 options(click to expand)
- 262 options in 1 group(s): journey_indexes [0] has 262 options
- Options by number of flights: 1 flight: 83, 2 flights: 179
- Airlines in the reply: 6E (156 flights), AI (89 flights), IX (67 flights), H1 (38 flights), SG (28 flights), EK (20 flights), SQ (18 flights), EY (16 flights), QP (6 flights), WY (2 flights), 9I (1 flights)
- 1021 fare options in total; 47 distinct fare families (fare_ref)
- Cheapest adult total: 1,799 (Series Purchase)
- Fares with a meal included (has_meal): 159; with a free seat: 183
- Fares with check-in baggage included: 998; hand baggage only: 15; no baggage stated: 8
- Fares whose attributes differ between flights (varies_by_segment): 451; ask detail=segment to see them per flight
- Refundability: PARTIALLY_REFUNDABLE 692, not stated 188, NON_REFUNDABLE 141
- 46 distinct fare rules in fare_rules; 554 fares without a rule known at search
- Reply carries valid_till (option_id and price_id expire then); request: 1 adult, 0 child, 0 infant, cabin_class 1
Request body
HTTP 200 · 13084 ms · complete request body (collapsible viewer)
{
"segments": [
{
"from": "DEL",
"to": "BOM",
"date": "2026-11-20"
}
],
"adult": 1,
"child": 0,
"infant": 0,
"cabin_class": 1
}Reply
HTTP 200 · 13084 ms · complete response body (collapsible viewer)
{
"search_id": "7ff2da2f-6181-43d9-8be4-29d49268631b",
"status": "completed",
"valid_till": "2026-10-21T01:13:37+05:30",
"fare_rules": {
"fr_1": {
"cancellation": [
{
"allowed": true,
"percent": 100,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "PerTicket"
}
],
"date_change": [
{
"allowed": false,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 2,
"unit": "HOURS"
},
"text": "Non changeable"
},
{
"allowed": true,
"amount": 3000,
"from": {
"value": 2,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "PerTicket"
}
]
},
"fr_2": {
"cancellation": [
{
"allowed": false,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 2,
"unit": "HOURS"
},
"text": "Non refundable"
},
{
"allowed": true,
"amount": 3500,
"from": {
"value": 2,
"unit": "HOURS"
},
"to": {
"value": 3,
"unit": "DAYS"
},
"text": "PerTicket"
},
{
"allowed": true,
"amount": 2500,
"from": {
"value": 3,
"unit": "DAYS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "PerTicket"
}
],
"date_change": [
{
"allowed": false,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 2,
"unit": "HOURS"
},
"text": "Non changeable"
},
{
"allowed": true,
"amount": 1000,
"from": {
"value": 2,
"unit": "HOURS"
},
"to": {
"value": 3,
"unit": "DAYS"
},
"text": "PerTicket"
},
{
"allowed": true,
"amount": 300,
"from": {
"value": 3,
"unit": "DAYS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "PerTicket"
}
]
},
"fr_3": {
"cancellation": [
{
"allowed": false,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 2,
"unit": "HOURS"
},
"text": "Non refundable"
},
{
"allowed": true,
"amount": 999,
"from": {
"value": 2,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "PerTicket"
}
],
"date_change": [
{
"allowed": false,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 2,
"unit": "HOURS"
},
"text": "Non changeable"
},
{
"allowed": true,
"amount": 250,
"from": {
"value": 2,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "PerTicket"
}
]
},
"fr_4": {
"cancellation": [
{
"allowed": false,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 2,
"unit": "HOURS"
},
"text": "Non refundable"
},
{
"allowed": true,
"amount": 5000,
"from": {
"value": 2,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "PerTicket"
}
],
"date_change": [
{
"allowed": false,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 2,
"unit": "HOURS"
},
"text": "Non changeable"
},
{
"allowed": true,
"amount": 3000,
"from": {
"value": 2,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "PerTicket"
}
]
},
"fr_5": {
"cancellation": [
{
"allowed": true,
"amount": 5023.22,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Non-Refundable"
}
],
"date_change": [
{
"allowed": true,
"amount": 3506.78,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Changeable"
}
]
},
"fr_6": {
"cancellation": [
{
"allowed": true,
"amount": 3506.78,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Non-Refundable"
}
],
"date_change": [
{
"allowed": true,
"amount": 1042.56,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Changeable"
}
]
},
"fr_7": {
"cancellation": [
{
"allowed": true,
"amount": 1042.56,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Non-Refundable"
}
],
"date_change": [
{
"allowed": true,
"amount": 284.33,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Changeable"
}
]
},
"fr_8": {
"cancellation": [
{
"allowed": true,
"amount": 5000,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure"
}
],
"date_change": [
{
"allowed": true,
"amount": 3500,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Reissue"
}
]
},
"fr_9": {
"cancellation": [
{
"allowed": true,
"amount": 3500,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure"
}
],
"date_change": [
{
"allowed": true,
"amount": 1000,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Reissue"
}
]
},
"fr_10": {
"cancellation": [
{
"allowed": true,
"amount": 999,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure"
}
],
"date_change": [
{
"allowed": true,
"amount": 250,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Reissue"
}
]
},
"fr_11": {
"cancellation": [
{
"allowed": true,
"amount": 9477.77,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Non-Refundable"
}
],
"date_change": [
{
"allowed": true,
"amount": 0,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Changeable"
}
]
},
"fr_12": {
"cancellation": [
{
"allowed": true,
"amount": 4738.89,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Refundable"
}
],
"date_change": [
{
"allowed": true,
"amount": 0,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Changeable"
}
]
},
"fr_13": {
"cancellation": [
{
"allowed": true,
"amount": 0,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Refundable"
}
],
"date_change": [
{
"allowed": true,
"amount": 0,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "Before departure — Changeable"
}
]
},
"fr_34": {
"cancellation": [
{
"allowed": false,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 1,
"unit": "HOURS"
},
"text": "Non refundable"
},
{
"allowed": true,
"amount": 0,
"from": {
"value": 1,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "PerTicket"
}
],
"date_change": [
{
"allowed": false,
"from": {
"value": 0,
"unit": "HOURS"
},
"to": {
"value": 1,
"unit": "HOURS"
},
"text": "Non changeable"
},
{
"allowed": true,
"amount": 0,
"from": {
"value": 1,
"unit": "HOURS"
},
"to": {
"value": 365,
"unit": "DAYS"
},
"text": "PerTicket"
}
]
}
},
"results": [
{
"journey_indexes": [
0
],
"options": [
{
"option_id": "b3b3cd7a-b77c-4d47-a03d-3fdd8e03d5fa",
"segments": [
{
"segment_index": 0,
"journey_index": 0,
"segment_id": "DEL_BOM_AI_2975",
"from": "DEL",
"to": "BOM",
"airline_code": "AI",
"airline_name": "Air India",
"aircraft_type": "Airbus A320neo",
"flight_number": "2975",
"departure_time": "2026-11-20T06:30:00",
"departure_terminal": "3",
"arrival_time": "2026-11-20T08:55:00",
"arrival_terminal": "2",
"duration": 145
}
],
"fare_options": [
{
"price_id": "122df20b-6bab-4891-a3cf-5a96d0fb8788",
"fare_rules": {
"0": "fr_1"
},
"has_free_seat": true,
"adult": {
"fare": {
"base_fare": 7953,
"yq": 549,
"yr": 170,
"booking_fee": 100,
"other_taxes": 675,
"total_fare": 9857.94,
"net_fare": 9857.94,
"pax_count": 1
},
"fare_ref": "Eco Value",
"refundable_type": "PARTIALLY_REFUNDABLE",
"cabin_class": "Economy",
"booking_class": "W",
"fare_basis": "WU1YXSII",
"baggage": {
"hand": {
"kg": 7
},
"checkin": {
"kg": 15
}
}
},
"varies_by_segment": false
},
{
"price_id": "92b87d0f-f1cc-4383-a3a0-56ffab603ee4",
"fare_rules": {
"0": "fr_2"
},
"has_free_seat": true,
"adult": {
"fare": {
"base_fare": 8453,
"yq": 549,
"yr": 170,
"booking_fee": 100,
"other_taxes": 700,
"total_fare": 10382.94,
"net_fare": 10382.94,
"pax_count": 1
},
"fare_ref": "Eco Classic",
"refundable_type": "PARTIALLY_REFUNDABLE",
"cabin_class": "Economy",
"booking_class": "W",
"fare_basis": "WU1YWSII",
"baggage": {
"hand": {
"kg": 7
},
"checkin": {
"kg": 20
}
}
},
"varies_by_segment": false
},
{
"price_id": "3d35da1d-f41b-4be2-91e5-e88208e1ad8a",
"fare_rules": {
"0": "fr_3"
},
"has_free_seat": true,
"adult": {
"fare": {
"base_fare": 9453,
"yq": 549,
"yr": 170,
"booking_fee": 100,
"other_taxes": 750,
"total_fare": 11432.94,
"net_fare": 11432.94,
"pax_count": 1
},
"fare_ref": "Eco Flex",
"refundable_type": "PARTIALLY_REFUNDABLE",
"cabin_class": "Economy",
"booking_class": "W",
"fare_basis": "WU1YFSII",
"baggage": {
"hand": {
"kg": 7
},
"checkin": {
"kg": 25
}
}
},
"varies_by_segment": false
},
"… 12 more (open the viewer)"
]
},
{
"option_id": "0227392d-425d-4644-8105-95be1ed8580d",
"segments": [
{
"segment_index": 0,
"journey_index": 0,
"segment_id": "DEL_DXB_EK_515",
"from": "DEL",
"to": "DXB",
"airline_code": "EK",
"airline_name": "Emirates",
"aircraft_type": "Boeing 77W",
"flight_number": "515",
"stops": 1,
"departure_time": "2026-11-20T21:30:00",
"departure_terminal": "3",
"arrival_time": "2026-11-20T23:59:00",
"arrival_terminal": "3",
"duration": 239,
"connecting_time": 561
},
{
"segment_index": 1,
"journey_index": 0,
"segment_id": "DXB_BOM_EK_506",
"from": "DXB",
"to": "BOM",
"airline_code": "EK",
"airline_name": "Emirates",
"aircraft_type": "Boeing 77W",
"flight_number": "506",
"stops": 1,
"departure_time": "2026-11-21T09:20:00",
"departure_terminal": "3",
"arrival_time": "2026-11-21T13:55:00",
"arrival_terminal": "2",
"duration": 185
}
],
"fare_options": [
{
"price_id": "9047ac43-51c6-4f90-a1ff-deeac6b621c9",
"fare_rules": {
"0": "fr_11"
},
"has_meal": true,
"adult": {
"fare": {
"base_fare": 21275.71,
"yq": 9667.34,
"other_taxes": 3923.81,
"total_fare": 38341.41,
"net_fare": 38341.41,
"pax_count": 1
},
"fare_ref": "Eco Saver",
"refundable_type": "NON_REFUNDABLE",
"cabin_class": "Economy",
"booking_class": "T",
"baggage": {
"checkin": {
"kg": 25
}
}
},
"varies_by_segment": true
},
{
"price_id": "3ac4b337-0cb0-4fdd-b580-935522a64676",
"fare_rules": {
"0": "fr_12"
},
"has_meal": true,
"adult": {
"fare": {
"base_fare": 35255.43,
"yq": 9667.34,
"other_taxes": 3923.81,
"total_fare": 52918.23,
"net_fare": 52918.23,
"pax_count": 1
},
"fare_ref": "Eco Flex",
"refundable_type": "PARTIALLY_REFUNDABLE",
"cabin_class": "Economy",
"booking_class": "K",
"baggage": {
"checkin": {
"kg": 30
}
}
},
"varies_by_segment": true
},
{
"price_id": "d8eae842-2261-45ed-ba00-9fb9c3acdc04",
"fare_rules": {
"0": "fr_13"
},
"has_meal": true,
"adult": {
"fare": {
"base_fare": 62320.16,
"yq": 9667.34,
"other_taxes": 3923.81,
"total_fare": 81129.77,
"net_fare": 81129.77,
"pax_count": 1
},
"fare_ref": "Eco Special",
"refundable_type": "PARTIALLY_REFUNDABLE",
"cabin_class": "Economy",
"booking_class": "X",
"baggage": {
"checkin": {
"kg": 35
}
}
},
"varies_by_segment": true
}
]
},
{
"option_id": "81ac06dd-3882-437a-bc69-6bece65f20e3",
"segments": [
{
"segment_index": 0,
"journey_index": 0,
"segment_id": "DEL_VNS_H1_965",
"from": "DEL",
"to": "VNS",
"airline_code": "H1",
"airline_name": "Hahn Air",
"operating_airline_code": "SG",
"operating_airline_name": "Spicejet",
"aircraft_type": "Boeing 737",
"flight_number": "965",
"stops": 1,
"departure_time": "2026-11-20T15:50:00",
"departure_terminal": "1D",
"arrival_time": "2026-11-20T17:20:00",
"duration": 90,
"connecting_time": 210
},
{
"segment_index": 1,
"journey_index": 0,
"segment_id": "VNS_BOM_H1_9041",
"from": "VNS",
"to": "BOM",
"airline_code": "H1",
"airline_name": "Hahn Air",
"operating_airline_code": "SG",
"operating_airline_name": "Spicejet",
"aircraft_type": "Boeing 737",
"flight_number": "9041",
"departure_time": "2026-11-20T20:50:00",
"arrival_time": "2026-11-20T23:20:00",
"arrival_terminal": "1",
"duration": 150
}
],
"fare_options": [
{
"price_id": "a5b18676-5237-4e92-81aa-f69325a1e288",
"fare_rules": {
"0": "fr_34"
},
"adult": {
"fare": {
"base_fare": 19554,
"yq": 6488,
"yr": 9000,
"other_taxes": 1994,
"total_fare": 37272,
"net_fare": 37272,
"pax_count": 1
},
"fare_ref": "Spicejet Economy Class",
"refundable_type": "NON_REFUNDABLE",
"cabin_class": "Economy",
"booking_class": "K",
"fare_basis": "KOWSG",
"baggage": {
"checkin": {
"kg": 50,
"pieces": 2
}
}
},
"varies_by_segment": true
},
{
"price_id": "3e1c92cb-604f-41d3-95ac-29e671d31a74",
"adult": {
"fare": {
"base_fare": 23512.46,
"yq": 6444.88,
"other_taxes": 9089.18,
"total_fare": 41188.49,
"net_fare": 41188.49,
"pax_count": 1
},
"fare_ref": "Economy",
"refundable_type": "NON_REFUNDABLE",
"cabin_class": "Economy",
"booking_class": "K",
"baggage": {
"checkin": {
"pieces": 1
}
}
},
"varies_by_segment": true
}
]
}
]
}
]
}This view shows 3 of the 262 options in the reply, chosen so that each of these is present. The fare_rules table shows the 14 rules these options point at, of 46 in the reply. For the entire JSON, open the raw record.
- An option with one flight (a direct flight). → group 0: option 0 (AI 2975 DEL-BOM)
- An option with two flights (a connection). → group 0: option 1 (EK 515 DEL-DXB + EK 506 DXB-BOM)
- An option where a flight is operated by another airline than the one selling it (operating_airline_code present). → group 0: option 62 (H1 965 DEL-VNS + H1 9041 VNS-BOM)
- An option with at least one fare that includes a meal (has_meal true). → group 0: option 0 (AI 2975 DEL-BOM)
Keys and what they mean
Request
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| segments[] | array | required, 1 to 6 | must read | The legs you search: one for one way, two for a return (second from the destination back), up to six for a multi-city trip. |
| segments[].from | string | required | must read | Departure airport, IATA code. |
| segments[].to | string | required | must read | Arrival airport, IATA code. |
| segments[].date | date | required | must read | Departure date, YYYY-MM-DD, local to the departure airport. |
| adult | integer | required, 1 to 9 | must read | Adults travelling. child and infant default to 0; an infant needs an adult. |
| cabin_class | integer | optional | useful | 1 economy (default), 2 premium economy, 3 business, 4 first. |
| detail | string | optional | useful | journey (default) or segment. segment adds segments[] inside every fare option with the fare attributes per flight. |
| include_fare_rules | boolean | optional, default true | informational | false leaves fare_rules out of the reply and off every fare; smaller reply. |
| Total: 8 keys | ||||
Reply
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| search_id | string | always | informational | Id of this search, for support questions. |
| valid_till | datetime | always | must read | Until when an option_id and price_id of this reply can be sent to reprice. After it, search again. |
| fare_rules | object | unless include_fare_rules is false | useful | Every distinct fare rule of the reply keyed by id (fr_1, fr_2, …). Fares point at them; ids mean nothing outside this reply. |
| results[] | array | always | must read | One group per set of journeys the fares cover. Pick one option and one fare from each group until every journey of your request is covered. |
| results[].journey_indexes | array of integer | always | must read | Which journeys of your request this group's fares cover: [0] onward only, [1] return only, [0, 1] a combined fare for both. |
| results[].options[].option_id | string | always | must read | Names the flights of this option. Send it to reprice with the price_id of the chosen fare. |
| results[].options[].segments[] | array | always | must read | The flights of this option in order, each named by (journey_index, segment_index); segment_index restarts at 0 in every journey. |
| results[].options[].segments[].operating_airline_code | string | only on a codeshare | useful | The airline that flies the aircraft when it differs from airline_code, the airline selling the seat. Show it to the traveller. |
| results[].options[].fare_options[] | array | always | must read | The fares sold on exactly these flights. Each prices the whole option once; no amount appears anywhere else. |
| results[].options[].fare_options[].price_id | string | always | must read | Names this fare. Send it to reprice with the option_id. |
| results[].options[].fare_options[].adult | object | always | must read | What this fare gives an adult: fare (the price for the whole option), fare_ref, refundable_type, cabin_class, booking_class, fare_basis, baggage. child and infant appear only when requested. |
| results[].options[].fare_options[].adult.fare.total_fare | number | always | must read | What the traveller pays for one adult on this option, taxes included. |
| results[].options[].fare_options[].adult.fare.net_fare | number | always | must read | What you pay us for one adult: total_fare less your commission. |
| results[].options[].fare_options[].adult.baggage | object | when the airline states it | useful | Allowance included in the fare: hand and checkin, each {kg} and/or {pieces}. Absent = not stated. |
| results[].options[].fare_options[].fare_rules | object | when a rule is known at search | useful | Journey index → id in the top-level fare_rules. A missing index has no rule known at search; the reprice reply carries the final rules. |
| results[].options[].fare_options[].varies_by_segment | boolean | always | informational | true when a later flight of this fare differs from the first in cabin, meal, booking class, fare basis or baggage. Ask detail=segment to see them per flight. |
| Total: 16 keys | ||||
Errors this call answers with (3)
| HTTP | code | message | detail | when |
|---|---|---|---|---|
| 401 | 9001 | Authentication required | Invalid token | Missing, expired or foreign token; also when the API cannot be reached. |
| 400 | 5100 | Invalid search request | cabin_class must be 1 (economy), 2 (premium), 3 (business), or 4 (first) | errors[] has field cabin_class, rule one_of. Same for fare_types and the engine's own checks (dates, airport codes, pax counts). |
| 500 | 9000 | Something went wrong |
Questions developers ask (4)
- What do I send to reprice for a domestic return?
- Two items: one option and one fare from group [0] (onward) and one from group [1] (return). An international return has one group [0, 1] and one item.
- Why does commission not appear on my fares?
- Zero amounts are left out. commission appears only when a commission rule applies to your account; net_fare is then total_fare less it.
- How long can I use an option_id and price_id?
- Until valid_till of the search reply. After it, search again.
- What does varies_by_segment true mean?
- A later flight of the fare differs from the first in cabin, meal, booking class, fare basis or baggage. Send detail=segment to see every flight.
▸2. RepricePOST /flights/reprice1 items
What this step returned: 1 items(click to expand)
- 1 item(s) sent: option eff1ddbb… / price 520060e3…
- 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)
- Price unchanged since search (no messages)
- 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 3,002, net 3,002; itinerary_id expires at valid_till
- 0 fare rule(s) in the reply
Request body
HTTP 200 · 6692 ms · complete request body (collapsible viewer)
{
"items": [
{
"option_id": "eff1ddbb-334e-4048-9709-c75d1ab02217",
"price_id": "520060e3-da45-4201-b044-3550b51b7db8"
}
]
}Reply
HTTP 200 · 6692 ms · complete response body (collapsible viewer)
{
"itinerary_id": "2c7f88f4-1e04-4f13-b3ed-23f1c1b94353",
"valid_till": "2026-10-21T00:43:47+05:30",
"results": [
{
"journey_indexes": [
0
],
"option_id": "eff1ddbb-334e-4048-9709-c75d1ab02217",
"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": "520060e3-da45-4201-b044-3550b51b7db8",
"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
}
}
},
"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": 899,
"yq": 850,
"airline_gst": 96,
"booking_fee": 100,
"other_taxes": 319,
"total_fare": 3001.94,
"net_fare": 3001.94,
"pax_count": 1
},
"total": {
"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
}
}
}Keys and what they mean
Request
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| items[] | array | required, one per group | must read | One 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_id | string | required | must read | The option_id from the search reply. |
| items[].price_id | string | required | must read | The 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
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| itinerary_id | string | always | must read | Names the repriced itinerary. Send it to ancillaries, seat map and book. |
| valid_till | datetime | always | must read | Until when the itinerary_id can be booked. After it, book answers 410: reprice again. |
| results[] | array | always | must read | One entry per item sent: journey_indexes, option_id, the flights (segments) and the one fare, priced again. |
| results[].segments[] | array | always | must read | The flights in order, each named by (journey_index, segment_index); segment_index restarts at 0 in every journey. |
| results[].fare | object | always | must read | The 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.total | object | always | must read | The 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) | object | always (child, infant when requested) | useful | The 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_requirements | object | always | must read | What 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_hold | boolean | always | must read | true when this fare may be booked on hold (book with is_hold true); false: book directly, paid at once. |
| fare_rules | object | when known | useful | The 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[] | array | only when the price changed | must read | One 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)
| HTTP | code | message | detail | when |
|---|---|---|---|---|
| 401 | 9001 | Authentication required | Invalid token | |
| 400 | 5100 | Invalid search request | option_id and price_id are required | Also 'each review item needs option_id and price_id'. |
| 404 | 5103 | Flight not found | option_id or price_id not in a stored search. | |
| 410 | 5102 | Search results have expired | ||
| 502 | 5001 | The airline or supplier could not complete the request | Reprice failed at the airline. | |
| 504 | 5002 | A 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/ancillaries21 items
What this step returned: 21 items(click to expand)
- 1 flight(s) in segments[]: (journey 0, segment 0) IX 1038 DEL-NMI
- 10 bags (per journey): journey 0: 10 items
- bags: price from 2,100 to 18,750; free items: 0
- 11 meals (per flight): (journey 0, segment 0): 11 items
- meals: price from 100 to 600; free items: 0
- No other items offered on this itinerary
Request body
HTTP 200 · 134 ms · complete request body (collapsible viewer)
{
"itinerary_id": "2c7f88f4-1e04-4f13-b3ed-23f1c1b94353"
}Reply
HTTP 200 · 134 ms · complete response body (collapsible viewer)
{
"itinerary_id": "2c7f88f4-1e04-4f13-b3ed-23f1c1b94353",
"segments": [
{
"journey_index": 0,
"segment_index": 0,
"airline_code": "IX",
"flight_number": "1038",
"from": "DEL",
"to": "NMI"
}
],
"baggage": [
{
"journey_index": 0,
"items": [
{
"code": "9519",
"label": "CABIN BAGGAGE 5KGS",
"price": 3500
},
{
"code": "9520",
"label": "CABIN BAGGAGE 3KGS",
"price": 2100
},
{
"code": "9521",
"label": "XCESS BAGGAGE 25KG",
"price": 18750
},
"… 7 more (open the viewer)"
]
}
],
"meal": [
{
"journey_index": 0,
"segment_index": 0,
"items": [
{
"code": "7227",
"label": "Shondesh Tiramisu",
"price": 250
},
{
"code": "7228",
"label": "Paneer Makhani with Jeera Aloo Vegetable Pulao",
"price": 600
},
{
"code": "7229",
"label": "Vegetable Manchurian with Fried Rice",
"price": 600
},
"… 8 more (open the viewer)"
]
}
],
"other": []
}Keys and what they mean
Request
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| itinerary_id | string | required | must read | The itinerary_id from reprice. An expired one answers 404: reprice again. |
| Total: 1 keys | ||||
Reply
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| segments[] | array | always | useful | The flights of the itinerary, each named by (journey_index, segment_index), with airline_code, flight_number, from and to. |
| baggage[] | array | always (empty when none) | must read | Extra bags per journey: journey_index and items. A bag covers every flight of its journey, so it has no segment_index. |
| meal[] | array | always (empty when none) | must read | Meals per flight: journey_index, segment_index and items. |
| other[] | array | always (empty when none) | useful | Other items per flight (priority check-in, bundles): journey_index, segment_index and items. |
| <list>[].items[] | array | always | must read | What can be bought: code (send it to book), label (show it), price (per passenger, INR). |
| Total: 5 keys | ||||
Errors this call answers with (4)
| HTTP | code | message | detail | when |
|---|---|---|---|---|
| 401 | 9001 | Authentication required | Invalid token | |
| 400 | 5100 | Invalid search request | itinerary_id is required | errors[]: field itinerary_id, rule required. |
| 404 | 5104 | Itinerary not found or expired | Unknown or expired itinerary_id. | |
| 502 | 5001 | The 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-map168 seats
What this step returned: 168 seats(click to expand)
- 1 flight(s) with a seat map of 1 in the itinerary: (journey 0, segment 0) Boeing 7M8, 168 seats
- 168 seats available of 168; free: 10; paid: 158 (from 300 to 1,700)
- Window 53, aisle 56, middle 59; exit row 0; extra leg room 0; infant allowed 0
Request body
HTTP 200 · 2782 ms · complete request body (collapsible viewer)
{
"itinerary_id": "2c7f88f4-1e04-4f13-b3ed-23f1c1b94353"
}Reply
HTTP 200 · 2782 ms · complete response body (collapsible viewer)
{
"itinerary_id": "2c7f88f4-1e04-4f13-b3ed-23f1c1b94353",
"segments": [
{
"journey_index": 0,
"segment_index": 0,
"airline_code": "IX",
"flight_number": "1038",
"from": "DEL",
"to": "NMI"
}
],
"seats": [
{
"journey_index": 0,
"segment_index": 0,
"aircraft_type": "Boeing 7M8",
"seats": [
{
"aisle": false,
"amount": 1700,
"code": "RA001347437478235030013494846406OWCMCF4L8IX|2648",
"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": "RA001347437478235030013494846406OWCMCF4L8IX|2649",
"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": "RA001347437478235030013494846406OWCMCF4L8IX|2650",
"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
}
]
}Keys and what they mean
Request
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| itinerary_id | string | required | must read | The itinerary_id from reprice. |
| Total: 1 keys | ||||
Reply
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| segments[] | array | always | useful | The flights of the itinerary, each named by (journey_index, segment_index), with airline_code, flight_number, from and to. |
| seats[] | array | always (empty when the airline gives no map) | must read | One seat map per flight: journey_index, segment_index, aircraft_type, total_seats and seats. |
| seats[].seats[] | array | always | must read | Every 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 / middle | boolean | always | useful | Where the seat is in its row. |
| seats[].seats[].exit_row / leg_room / infant / near_wings / reclining | boolean | always | useful | Seat 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)
| HTTP | code | message | detail | when |
|---|---|---|---|---|
| 401 | 9001 | Authentication required | Invalid token | |
| 400 | 5100 | Invalid search request | itinerary_id is required | |
| 404 | 5104 | Itinerary not found or expired | ||
| 502 | 5001 | The airline or supplier could not complete the request |
▸5. Book on holdPOST /flights/book1 passengers
What this step returned: 1 passengers(click to expand)
- Booked on hold (is_hold True) with 1 passenger(s): ADULT 1
- Status ONHOLD, booking_id AIOR799682, amount 3,002, pay_till given
- GST details sent: no; ancillaries selected: 0
Request body
HTTP 200 · 8270 ms · complete request body (collapsible viewer)
{
"itinerary_id": "2c7f88f4-1e04-4f13-b3ed-23f1c1b94353",
"is_hold": true,
"pax_details": [
{
"first_name": "Rohan",
"last_name": "Chawla",
"pax_type": "ADULT",
"title": "Mr",
"gender": "male",
"dob": "1990-05-12",
"phone": "9876543210",
"email": "rohan.verma@example.com"
}
]
}Reply
HTTP 200 · 8270 ms · complete response body (collapsible viewer)
{
"booking_id": "AIOR799682",
"itinerary_id": "2c7f88f4-1e04-4f13-b3ed-23f1c1b94353",
"status": "ONHOLD",
"amount": 3001.94,
"pay_till": "2026-10-21T03:13:00Z"
}Keys and what they mean
Request
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| itinerary_id | string | required | must read | The itinerary_id from reprice, before its valid_till. |
| is_hold | boolean | optional, default false | must read | false: 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[] | array | required, one per passenger | must read | Every passenger of the search, adults first: first_name, last_name, pax_type (ADULT, CHILD, INFANT), title, gender, dob, phone and email. |
| pax_details[].passport_details | object | when reprice says passport_mandatory | useful | passport_number, passport_issue_date, passport_expiry_date, passport_issue_country, nationality. |
| pax_details[].ancillaries | object | optional | useful | What 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_details | object | optional; required when reprice says is_gst_mandatory | useful | The company on the invoice: name, number (GSTIN), address, email, mobile. |
| Total: 6 keys | ||||
Reply
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| booking_id | string | always | must read | Your booking's id. Send it to booking details, confirm-hold and release. |
| status | string | always | must read | ONHOLD (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_till | datetime | on a hold | must read | Until when the hold can be confirmed; after it the airline releases the seats. |
| amount | number | always | must read | What the booking costs (INR); taken at once for a direct booking, at confirm-hold for a hold. |
| itinerary_id | string | always | informational | The itinerary that was booked. |
| Total: 5 keys | ||||
Errors this call answers with (7)
| HTTP | code | message | detail | when |
|---|---|---|---|---|
| 401 | 9001 | Authentication required | Invalid token | |
| 403 | 9002 | You do not have permission for this action | Role without bookings.create (Finance, Operation, Tech). | |
| 400 | 3000 | Invalid request | (the API's detail text) | |
| 400 | 9003 | Some fields are missing or invalid | Schema validation of the body (required fields, formats); errors[] lists them. | |
| 503 | 3003 | A service the API depends on is unavailable | (the API's text) | the API answered 5xx or did not answer. |
| 409 | 3101 | Hold booking limit reached | ||
| 500 | 9000 | Something went wrong | Payment 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/details1 passengers
What this step returned: 1 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 LVE69F, ticket BX21HJ00021-1, fare Value X/XNRA015, total 3,002, net 3,002, baggage hand 7kg, checkin 15kg
- PNR on 1 of 1 passenger-journeys; 1 passenger(s): ADULT Rohan Chawla
- Booking price: base 899, yq 850, other taxes 319, total 3,002, net 3,002
Request body
HTTP 200 · 126 ms · complete request body (collapsible viewer)
{
"booking_id": "AIOR799682"
}Reply
HTTP 200 · 126 ms · complete response body (collapsible viewer)
{
"booking_id": "AIOR799682",
"status": "ONHOLD",
"payment_status": "PENDING",
"created_at": "2026-10-21T00:13:50Z",
"pay_till": "2026-10-21T03:13: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": "Chawla",
"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": "LVE69F",
"ticket_number": "BX21HJ00021-1",
"fare_ref": "Value",
"refundable_type": "PARTIALLY_REFUNDABLE",
"cabin_class": "Economy",
"booking_class": "X",
"fare_basis": "XNRA015",
"baggage": {
"hand": {
"kg": 7
},
"checkin": {
"kg": 15
}
}
}
]
}
],
"price": {
"base_fare": 899,
"yq": 850,
"airline_gst": 96,
"booking_fee": 100,
"other_taxes": 319,
"agent_markup": 327.24,
"total_fare": 3001.94,
"net_fare": 3001.94
}
}Keys and what they mean
Request
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| booking_id | string | required | must read | The id book returned. |
| Total: 1 keys | ||||
Reply
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| status | string | always | must read | The booking's state: CREATED, ONHOLD, SUCCESS, PNR_RELEASED, CANCELLED, FAILED. |
| payment_status | string | always | must read | PENDING until paid, then SUCCESS; FAILED or REFUNDED later. |
| pay_till | datetime | on a hold | must read | Until when a held booking can be confirmed; after it the airline releases the seats. |
| journeys[] | array | always | must read | The 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[].pnr | string | once the airline confirmed | must read | The airline's record locator for this passenger on this journey. Empty until the hold or the ticket is confirmed. |
| journeys[].passengers[].status | string | always | must read | PENDING until confirmed, then CONFIRMED; CANCELLED, VOIDED or REISSUED when something happened to this passenger on this journey. |
| price | object | always | must read | The 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[].fare | object | always | must read | What 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)
| HTTP | code | message | detail | when |
|---|---|---|---|---|
| 401 | 9001 | Authentication required | Invalid token | |
| 403 | 9002 | You do not have permission for this action | Role without bookings.read. | |
| 400 | 3000 | Invalid request | Booking_id is required | |
| 404 | 9005 | Not found | Booking 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 · 1838 ms · complete request body (collapsible viewer)
{
"booking_id": "AIOR799682"
}Reply (failed, HTTP 409)
HTTP 409 · 1838 ms · complete response body (collapsible viewer)
{
"code": 3105,
"message": "The hold could not be released; the PNR is still held",
"traceId": "dffd9c9f43f2367da9f86994dbe64bc8"
}Keys and what they mean
Request
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| booking_id | string | required | must read | A booking on hold. A booking that is not on hold answers an error. |
| Total: 1 keys | ||||
Reply
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| status | string | always | must read | PNR_RELEASED when the airline freed the seats. A release the airline refuses answers 409 (code 3105): the PNR is still held, try again later. |
| pnr | string | always | useful | The record locator that was released. |
| booking_id | string | always | informational | The booking released. |
| Total: 3 keys | ||||
Errors this call answers with (5)
| HTTP | code | message | detail | when |
|---|---|---|---|---|
| 401 | 9001 | Authentication required | Invalid token | |
| 403 | 9002 | You do not have permission for this action | Role without bookings.cancel. | |
| 400 | 3000 | Invalid request | Booking_id is required | |
| 404 | 9005 | Not found | Booking not found | |
| 409 | 3102 | Booking is not pending | Ticketed 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.