Domestic, return, 1 adult

DEL-BOM · return · 1 adult · booked on hold

Domestic return 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. Two search segments. Domestic fares are sold per direction: two groups, [0] and [1]; reprice takes two items.

1 Search: 337 options
2 Reprice: 2 items
3 Ancillaries: 82 items
4 Seat map: 602 seats
5 Book on hold: 1 passengers
6 Booking details: 1 passengers
7 Release the hold: 1 released

▸1. SearchPOST /flights/search337 options

What this step returned: 337 options(click to expand)

337 options in 2 group(s): journey_indexes [0] has 166 options; journey_indexes [1] has 171 options
Options by number of flights: 1 flight: 78, 2 flights: 259
Airlines in the reply: AI (214 flights), IX (145 flights), SG (60 flights), H1 (59 flights), EK (42 flights), SQ (34 flights), EY (32 flights), QP (6 flights), WY (2 flights), 6E (1 flights), 9I (1 flights)
1631 fare options in total; 42 distinct fare families (fare_ref)
Cheapest adult total: 1,799 (Series Purchase)
Fares with a meal included (has_meal): 316; with a free seat: 359
Fares with check-in baggage included: 1582; hand baggage only: 33; no baggage stated: 16
Fares whose attributes differ between flights (varies_by_segment): 875; ask detail=segment to see them per flight
Refundability: PARTIALLY_REFUNDABLE 1271, NON_REFUNDABLE 276, not stated 84
49 distinct fare rules in fare_rules; 892 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 · 17389 ms · complete request body (collapsible viewer)

{
  "segments": [
    {
      "from": "DEL",
      "to": "BOM",
      "date": "2026-11-20"
    },
    {
      "from": "BOM",
      "to": "DEL",
      "date": "2026-11-25"
    }
  ],
  "adult": 1,
  "child": 0,
  "infant": 0,
  "cabin_class": 1
}

HTTP 200 · 17389 ms · complete response body (collapsible viewer)

{
  "search_id": "6fe0a813-139b-40f8-b075-5cba3ca73ab7",
  "status": "completed",
  "valid_till": "2026-10-21T01:28:21+05:30",
  "fare_rules": {
    "fr_4": {
      "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_5": {
      "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_6": {
      "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_7": {
      "cancellation": [
        {
          "allowed": true,
          "amount": 4300,
          "from": {
            "value": 2,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          },
          "text": "Before departure — DELBOM - 2 hrs to 365 days Before departure"
        }
      ],
      "date_change": [
        {
          "allowed": true,
          "amount": 3000,
          "from": {
            "value": 2,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          },
          "text": "Before departure — DELBOM - 2 hrs to 365 days Before departure"
        }
      ]
    },
    "fr_12": {
      "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"
        }
      ]
    },
    "fr_9": {
      "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_10": {
      "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_11": {
      "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_1": {
      "cancellation": [
        {
          "allowed": true,
          "amount": 10000,
          "from": {
            "value": 0,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          },
          "text": "Before departure"
        }
      ],
      "date_change": [
        {
          "allowed": true,
          "amount": 7000,
          "from": {
            "value": 0,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          },
          "text": "Reissue"
        }
      ]
    },
    "fr_2": {
      "cancellation": [
        {
          "allowed": true,
          "amount": 7000,
          "from": {
            "value": 0,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          },
          "text": "Before departure"
        }
      ],
      "date_change": [
        {
          "allowed": true,
          "amount": 2000,
          "from": {
            "value": 0,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          },
          "text": "Reissue"
        }
      ]
    },
    "fr_3": {
      "cancellation": [
        {
          "allowed": true,
          "amount": 1998,
          "from": {
            "value": 0,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          },
          "text": "Before departure"
        }
      ],
      "date_change": [
        {
          "allowed": true,
          "amount": 500,
          "from": {
            "value": 0,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          },
          "text": "Reissue"
        }
      ]
    },
    "fr_8": {
      "cancellation": [
        {
          "allowed": true,
          "amount": 4300,
          "from": {
            "value": 2,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          },
          "text": "Before departure — BOMDEL - 2 hrs to 365 days Before departure"
        }
      ],
      "date_change": [
        {
          "allowed": true,
          "amount": 3000,
          "from": {
            "value": 2,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          },
          "text": "Before departure — BOMDEL - 2 hrs to 365 days Before departure"
        }
      ]
    }
  },
  "results": [
    {
      "journey_indexes": [
        0
      ],
      "options": [
        {
          "option_id": "89fb2e53-1956-453a-9b12-8ff9c6a922a9",
          "segments": [
            {
              "segment_index": 0,
              "journey_index": 0,
              "segment_id": "DEL_DBR_H1_9448",
              "from": "DEL",
              "to": "DBR",
              "airline_code": "H1",
              "airline_name": "Hahn Air",
              "aircraft_type": "Boeing 737",
              "flight_number": "9448",
              "stops": 1,
              "departure_time": "2026-11-20T09:15:00",
              "arrival_time": "2026-11-20T11:10:00",
              "duration": 115,
              "connecting_time": 130
            },
            {
              "segment_index": 1,
              "journey_index": 0,
              "segment_id": "DBR_BOM_H1_9066",
              "from": "DBR",
              "to": "BOM",
              "airline_code": "H1",
              "airline_name": "Hahn Air",
              "aircraft_type": "Boeing 737",
              "flight_number": "9066",
              "stops": 1,
              "departure_time": "2026-11-20T13:20:00",
              "arrival_time": "2026-11-20T16:15:00",
              "arrival_terminal": "1",
              "duration": 175
            }
          ],
          "fare_options": [
            {
              "price_id": "2d227363-fc35-4578-b1fc-7f3a3d4657d2",
              "adult": {
                "fare": {
                  "base_fare": 24630.84,
                  "yq": 6444.88,
                  "other_taxes": 9089.18,
                  "total_fare": 42354.26,
                  "net_fare": 42354.26,
                  "pax_count": 1
                },
                "fare_ref": "Economy",
                "refundable_type": "NON_REFUNDABLE",
                "cabin_class": "Economy",
                "booking_class": "K",
                "baggage": {
                  "checkin": {
                    "pieces": 1
                  }
                }
              },
              "varies_by_segment": true
            }
          ]
        },
        {
          "option_id": "a25c2139-2311-4ad5-a489-2ed729479a6a",
          "segments": [
            {
              "segment_index": 0,
              "journey_index": 0,
              "segment_id": "DEL_DXB_EK_517",
              "from": "DEL",
              "to": "DXB",
              "airline_code": "EK",
              "airline_name": "Emirates",
              "aircraft_type": "Boeing 77W",
              "flight_number": "517",
              "stops": 1,
              "departure_time": "2026-11-20T16:15:00",
              "departure_terminal": "3",
              "arrival_time": "2026-11-20T18:35:00",
              "arrival_terminal": "3",
              "duration": 230,
              "connecting_time": 560
            },
            {
              "segment_index": 1,
              "journey_index": 0,
              "segment_id": "DXB_BOM_EK_504",
              "from": "DXB",
              "to": "BOM",
              "airline_code": "EK",
              "airline_name": "Emirates",
              "aircraft_type": "Boeing 77W",
              "flight_number": "504",
              "stops": 1,
              "departure_time": "2026-11-21T03:55:00",
              "departure_terminal": "3",
              "arrival_time": "2026-11-21T08:30:00",
              "arrival_terminal": "2",
              "duration": 185
            }
          ],
          "fare_options": [
            {
              "price_id": "6c1cac06-d530-404a-aac8-9247c4012604",
              "fare_rules": {
                "0": "fr_4"
              },
              "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": "72a683aa-9a7a-4e72-8f8c-b91cebf33385",
              "fare_rules": {
                "0": "fr_5"
              },
              "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": "bce3ab71-582e-4bc6-bf4f-10b42b55b48b",
              "fare_rules": {
                "0": "fr_6"
              },
              "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": "21922973-fdd5-40f2-9bcb-f8a929e64702",
          "segments": [
            {
              "segment_index": 0,
              "journey_index": 0,
              "segment_id": "DEL_BOM_IX_1056",
              "from": "DEL",
              "to": "BOM",
              "airline_code": "IX",
              "airline_name": "Air India Express",
              "flight_number": "1056",
              "departure_time": "2026-11-20T08:50:00",
              "arrival_time": "2026-11-20T11:15:00",
              "duration": 145
            }
          ],
          "fare_options": [
            {
              "price_id": "7d49d0c9-cdab-467a-9c39-e908d8f8c293",
              "fare_rules": {
                "0": "fr_7"
              },
              "adult": {
                "fare": {
                  "base_fare": 6461.68,
                  "booking_fee": 100,
                  "other_taxes": 1715.48,
                  "total_fare": 8452.1,
                  "net_fare": 8452.1,
                  "pax_count": 1
                },
                "fare_ref": "Economy",
                "refundable_type": "PARTIALLY_REFUNDABLE",
                "cabin_class": "Economy",
                "booking_class": "Z",
                "baggage": {
                  "hand": {
                    "kg": 7
                  },
                  "checkin": {
                    "kg": 15
                  }
                }
              },
              "varies_by_segment": false
            }
          ]
        },
        "… 1 more (open the viewer)"
      ]
    },
    {
      "journey_indexes": [
        1
      ],
      "options": [
        {
          "option_id": "9afb8efe-f1bd-47f1-9b62-15e09ee10708",
          "segments": [
            {
              "segment_index": 0,
              "journey_index": 1,
              "segment_id": "BOM_IDR_AI_2591",
              "from": "BOM",
              "to": "IDR",
              "airline_code": "AI",
              "airline_name": "Air India",
              "aircraft_type": "Airbus A320neo",
              "flight_number": "2591",
              "stops": 1,
              "departure_time": "2026-11-25T07:40:00",
              "departure_terminal": "2",
              "arrival_time": "2026-11-25T09:10:00",
              "duration": 90,
              "connecting_time": 310
            },
            {
              "segment_index": 1,
              "journey_index": 1,
              "segment_id": "IDR_DEL_AI_1872",
              "from": "IDR",
              "to": "DEL",
              "airline_code": "AI",
              "airline_name": "Air India",
              "aircraft_type": "Airbus A320neo",
              "flight_number": "1872",
              "departure_time": "2026-11-25T14:20:00",
              "arrival_time": "2026-11-25T15:45:00",
              "arrival_terminal": "2",
              "duration": 85,
              "connecting_time": 310
            }
          ],
          "fare_options": [
            {
              "price_id": "c7105c51-9d24-4d78-919d-2f4059f013fc",
              "fare_rules": {
                "1": "fr_1"
              },
              "has_free_seat": true,
              "adult": {
                "fare": {
                  "base_fare": 11585,
                  "yq": 1200,
                  "yr": 340,
                  "other_taxes": 1166,
                  "total_fare": 14291,
                  "net_fare": 14291,
                  "pax_count": 1
                },
                "fare_ref": "ECO VALUE",
                "refundable_type": "PARTIALLY_REFUNDABLE",
                "cabin_class": "Economy",
                "booking_class": "L",
                "fare_basis": "LU1YXSII",
                "baggage": {
                  "hand": {
                    "kg": 7
                  },
                  "checkin": {
                    "kg": 15
                  }
                }
              },
              "varies_by_segment": true
            },
            {
              "price_id": "de4b7a4d-62ac-4962-bdd3-5b0b7e1ceffb",
              "fare_rules": {
                "1": "fr_2"
              },
              "has_free_seat": true,
              "adult": {
                "fare": {
                  "base_fare": 12585,
                  "yq": 1200,
                  "yr": 340,
                  "other_taxes": 1216,
                  "total_fare": 15341,
                  "net_fare": 15341,
                  "pax_count": 1
                },
                "fare_ref": "ECO CLASSIC",
                "refundable_type": "PARTIALLY_REFUNDABLE",
                "cabin_class": "Economy",
                "booking_class": "L",
                "fare_basis": "LU1YWSII",
                "baggage": {
                  "hand": {
                    "kg": 7
                  },
                  "checkin": {
                    "kg": 20
                  }
                }
              },
              "varies_by_segment": false
            },
            {
              "price_id": "249adf36-8114-4007-b694-efd21e1661c2",
              "fare_rules": {
                "1": "fr_3"
              },
              "has_free_seat": true,
              "adult": {
                "fare": {
                  "base_fare": 14585,
                  "yq": 1200,
                  "yr": 340,
                  "other_taxes": 1316,
                  "total_fare": 17441,
                  "net_fare": 17441,
                  "pax_count": 1
                },
                "fare_ref": "ECO FLEX",
                "refundable_type": "PARTIALLY_REFUNDABLE",
                "cabin_class": "Economy",
                "booking_class": "L",
                "fare_basis": "LU1YFSII",
                "baggage": {
                  "hand": {
                    "kg": 7
                  },
                  "checkin": {
                    "kg": 25
                  }
                }
              },
              "varies_by_segment": false
            },
            "… 3 more (open the viewer)"
          ]
        },
        {
          "option_id": "3e1f0c63-9ff4-424a-9440-da7b342be485",
          "segments": [
            {
              "segment_index": 0,
              "journey_index": 1,
              "segment_id": "BOM_DEL_IX_1050",
              "from": "BOM",
              "to": "DEL",
              "airline_code": "IX",
              "airline_name": "Air India Express",
              "flight_number": "1050",
              "departure_time": "2026-11-25T05:30:00",
              "arrival_time": "2026-11-25T07:55:00",
              "duration": 145
            }
          ],
          "fare_options": [
            {
              "price_id": "a1fb3967-6fd7-4f62-aaef-eb9fc23d8b01",
              "fare_rules": {
                "1": "fr_8"
              },
              "adult": {
                "fare": {
                  "base_fare": 4570.51,
                  "other_taxes": 1433.99,
                  "total_fare": 6004.5,
                  "net_fare": 6004.5,
                  "pax_count": 1
                },
                "fare_ref": "Economy",
                "refundable_type": "PARTIALLY_REFUNDABLE",
                "cabin_class": "Economy",
                "booking_class": "O",
                "baggage": {
                  "hand": {
                    "kg": 7
                  },
                  "checkin": {
                    "kg": 15
                  }
                }
              },
              "varies_by_segment": false
            }
          ]
        },
        {
          "option_id": "165115f1-c2cc-47ce-baae-6c4a95ae3bed",
          "segments": [
            {
              "segment_index": 0,
              "journey_index": 1,
              "segment_id": "BOM_DXB_EK_501",
              "from": "BOM",
              "to": "DXB",
              "airline_code": "EK",
              "airline_name": "Emirates",
              "aircraft_type": "Airbus A388",
              "flight_number": "501",
              "stops": 1,
              "departure_time": "2026-11-25T04:15:00",
              "departure_terminal": "2",
              "arrival_time": "2026-11-25T06:10:00",
              "arrival_terminal": "3",
              "duration": 205,
              "connecting_time": 225
            },
            {
              "segment_index": 1,
              "journey_index": 1,
              "segment_id": "DXB_DEL_EK_516",
              "from": "DXB",
              "to": "DEL",
              "airline_code": "EK",
              "airline_name": "Emirates",
              "aircraft_type": "Boeing 77W",
              "flight_number": "516",
              "stops": 1,
              "departure_time": "2026-11-25T09:55:00",
              "departure_terminal": "3",
              "arrival_time": "2026-11-25T14:40:00",
              "arrival_terminal": "3",
              "duration": 195
            }
          ],
          "fare_options": [
            {
              "price_id": "03e74d6f-49ab-49e4-883f-64c3d1424c59",
              "fare_rules": {
                "1": "fr_4"
              },
              "has_meal": true,
              "adult": {
                "fare": {
                  "base_fare": 16578.52,
                  "yq": 9667.34,
                  "other_taxes": 3942.76,
                  "total_fare": 33426.23,
                  "net_fare": 33426.23,
                  "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": "127427c2-08ea-473a-bc92-e36a4152ae1e",
              "fare_rules": {
                "1": "fr_5"
              },
              "has_meal": true,
              "adult": {
                "fare": {
                  "base_fare": 30446.4,
                  "yq": 9667.34,
                  "other_taxes": 3942.76,
                  "total_fare": 47881.73,
                  "net_fare": 47881.73,
                  "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": "53a2171d-91b0-4128-bd2d-ade0902b5555",
              "fare_rules": {
                "1": "fr_6"
              },
              "has_meal": true,
              "adult": {
                "fare": {
                  "base_fare": 57622.97,
                  "yq": 9667.34,
                  "other_taxes": 3942.76,
                  "total_fare": 76214.59,
                  "net_fare": 76214.59,
                  "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
            }
          ]
        },
        "… 1 more (open the viewer)"
      ]
    }
  ]
}

This view shows 8 of the 337 options in the reply, chosen so that each of these is present. The fare_rules table shows the 12 rules these options point at, of 49 in the reply. For the entire JSON, open the raw record.

An option with one flight (a direct flight). → group 0: option 2 (IX 1056 DEL-BOM); group 1: option 1 (IX 1050 BOM-DEL)
An option with two flights (a connection). → group 0: option 0 (H1 9448 DEL-DBR + H1 9066 DBR-BOM); group 1: option 0 (AI 2591 BOM-IDR + AI 1872 IDR-DEL)
An option where a flight is operated by another airline than the one selling it (operating_airline_code present). → group 0: option 6 (H1 1736 DEL-BOM); group 1: option 16 (SQ 423 BOM-SIN + SQ 4806 SIN-DEL)
An option with at least one fare that includes a meal (has_meal true). → group 0: option 1 (EK 517 DEL-DXB + EK 504 DXB-BOM); group 1: option 2 (EK 501 BOM-DXB + EK 516 DXB-DEL)

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

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/reprice2 items

What this step returned: 2 items(click to expand)

2 item(s) sent: option 33f7112a… / price 39baf0d4…; option 7ee707d5… / price f2973366…
Repriced option on journey_indexes [0]: 1 flight (IX 1463 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]: 2 flights (IX 1163 BOM-GOX, IX 2764 GOX-DEL); multi-flight reprice: yes
Fare Value : adult total 2,741, net 2,741; 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 5,743, net 5,743; itinerary_id expires at valid_till
0 fare rule(s) in the reply

Request body

HTTP 200 · 6123 ms · complete request body (collapsible viewer)

{
  "items": [
    {
      "option_id": "33f7112a-f10f-4975-8b0b-b614e38a2e41",
      "price_id": "39baf0d4-92fe-4741-939a-64e780f77a6e"
    },
    {
      "option_id": "7ee707d5-19b5-493c-a96e-98b7180cdafd",
      "price_id": "f2973366-f566-41ea-93f7-733fbb13ee24"
    }
  ]
}

HTTP 200 · 6123 ms · complete response body (collapsible viewer)

{
  "itinerary_id": "e33a765e-a35e-4ee7-a72b-cf59d64e2eba",
  "valid_till": "2026-10-21T00:58:30+05:30",
  "results": [
    {
      "journey_indexes": [
        0
      ],
      "option_id": "33f7112a-f10f-4975-8b0b-b614e38a2e41",
      "segments": [
        {
          "segment_index": 0,
          "journey_index": 0,
          "from": "DEL",
          "to": "NMI",
          "airline_code": "IX",
          "airline_name": "Air India Express",
          "aircraft_type": "Airbus A32Y",
          "flight_number": "1463",
          "departure_time": "2026-11-20T06:00:00",
          "departure_terminal": "1",
          "arrival_time": "2026-11-20T08:05:00",
          "duration": 125
        }
      ],
      "fare": {
        "price_id": "39baf0d4-92fe-4741-939a-64e780f77a6e",
        "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
      }
    },
    {
      "journey_indexes": [
        1
      ],
      "option_id": "7ee707d5-19b5-493c-a96e-98b7180cdafd",
      "segments": [
        {
          "segment_index": 0,
          "journey_index": 1,
          "from": "BOM",
          "to": "GOX",
          "airline_code": "IX",
          "airline_name": "Air India Express",
          "aircraft_type": "Boeing 7M8",
          "flight_number": "1163",
          "stops": 1,
          "departure_time": "2026-11-25T20:00:00",
          "departure_terminal": "2",
          "arrival_time": "2026-11-25T21:25:00",
          "duration": 85,
          "connecting_time": 20
        },
        {
          "segment_index": 1,
          "journey_index": 1,
          "from": "GOX",
          "to": "DEL",
          "airline_code": "IX",
          "airline_name": "Air India Express",
          "aircraft_type": "Airbus A320neo",
          "flight_number": "2764",
          "departure_time": "2026-11-25T21:45:00",
          "arrival_time": "2026-11-26T00:25:00",
          "arrival_terminal": "1",
          "duration": 160,
          "connecting_time": 20,
          "next_day": 1
        }
      ],
      "fare": {
        "price_id": "f2973366-f566-41ea-93f7-733fbb13ee24",
        "adult": {
          "fare": {
            "base_fare": 1001,
            "yq": 850,
            "other_taxes": 172,
            "total_fare": 2741,
            "net_fare": 2741,
            "pax_count": 1
          },
          "fare_ref": "Value",
          "cabin_class": "Economy",
          "booking_class": "EC",
          "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": 1900,
      "yq": 1700,
      "airline_gst": 96,
      "booking_fee": 100,
      "other_taxes": 491,
      "total_fare": 5742.94,
      "net_fare": 5742.94,
      "pax_count": 1
    },
    "total": {
      "base_fare": 1900,
      "yq": 1700,
      "airline_gst": 96,
      "booking_fee": 100,
      "other_taxes": 491,
      "total_fare": 5742.94,
      "net_fare": 5742.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

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/ancillaries82 items

What this step returned: 82 items(click to expand)

3 flight(s) in segments[]: (journey 0, segment 0) IX 1463 DEL-NMI; (journey 1, segment 0) IX 1163 BOM-GOX; (journey 1, segment 1) IX 2764 GOX-DEL
20 bags (per journey): journey 0: 10 items; journey 1: 10 items
bags: price from 2,100 to 18,750; free items: 0
37 meals (per flight): (journey 0, segment 0): 11 items; (journey 1, segment 0): 10 items; (journey 1, segment 1): 16 items
meals: price from 100 to 700; free items: 0
25 other items (per flight): (journey 1, segment 0): 13 items; (journey 1, segment 1): 12 items
other items: price from 0 to 6,000; free items: 10
Errors: add-ons on BOM_DEL_IX_1163 dropped: not a flight of this itinerary; add-ons on BOM_DEL_IX_1163 dropped: not a flight of this itinerary

Request body

HTTP 200 · 1612 ms · complete request body (collapsible viewer)

{
  "itinerary_id": "e33a765e-a35e-4ee7-a72b-cf59d64e2eba"
}

HTTP 200 · 1612 ms · complete response body (collapsible viewer)

{
  "itinerary_id": "e33a765e-a35e-4ee7-a72b-cf59d64e2eba",
  "segments": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "airline_code": "IX",
      "flight_number": "1463",
      "from": "DEL",
      "to": "NMI"
    },
    {
      "journey_index": 1,
      "segment_index": 0,
      "airline_code": "IX",
      "flight_number": "1163",
      "from": "BOM",
      "to": "GOX"
    },
    {
      "journey_index": 1,
      "segment_index": 1,
      "airline_code": "IX",
      "flight_number": "2764",
      "from": "GOX",
      "to": "DEL"
    }
  ],
  "baggage": [
    {
      "journey_index": 0,
      "items": [
        {
          "code": "6712",
          "label": "CABIN BAGGAGE 5KGS",
          "price": 3500
        },
        {
          "code": "6713",
          "label": "CABIN BAGGAGE 3KGS",
          "price": 2100
        },
        {
          "code": "6714",
          "label": "XCESS BAGGAGE 25KG",
          "price": 18750
        },
        "… 7 more (open the viewer)"
      ]
    },
    {
      "journey_index": 1,
      "items": [
        {
          "code": "PBCB",
          "label": "+ 5Kgs Xtra-Carry-On",
          "price": 3500
        },
        {
          "code": "PBCA",
          "label": "+3Kgs Xtra-Carry-On",
          "price": 2100
        },
        {
          "code": "PBAF",
          "label": "+ 25 Kg Xcess Baggage",
          "price": 18750
        },
        "… 7 more (open the viewer)"
      ]
    }
  ],
  "meal": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "items": [
        {
          "code": "5750",
          "label": "Shondesh Tiramisu",
          "price": 250
        },
        {
          "code": "5751",
          "label": "Paneer Makhani with Jeera Aloo  Vegetable Pulao",
          "price": 600
        },
        {
          "code": "5752",
          "label": "Vegetable Manchurian with Fried Rice",
          "price": 600
        },
        "… 8 more (open the viewer)"
      ]
    },
    {
      "journey_index": 1,
      "segment_index": 0,
      "items": [
        {
          "code": "VSDB",
          "label": "Shondesh Tiramisu",
          "price": 250
        },
        {
          "code": "VQSB",
          "label": "Quinoa Salad",
          "price": 400
        },
        {
          "code": "VHRB",
          "label": "Herb Roast Vegetable Roll",
          "price": 400
        },
        "… 7 more (open the viewer)"
      ]
    },
    {
      "journey_index": 1,
      "segment_index": 1,
      "items": [
        {
          "code": "VSDB",
          "label": "Shondesh Tiramisu",
          "price": 250
        },
        {
          "code": "VQSB",
          "label": "Quinoa Salad",
          "price": 400
        },
        {
          "code": "VPMB",
          "label": "Paneer Makhani with Jeera Aloo & Vegetable Pulao",
          "price": 600
        },
        "… 13 more (open the viewer)"
      ]
    }
  ],
  "other": [
    {
      "journey_index": 1,
      "segment_index": 0,
      "items": [
        {
          "code": "WCHS",
          "label": "Wheelchair Unable to ascend and descend step",
          "price": 1500
        },
        {
          "code": "WCHR",
          "label": "Wheelchair Unable to walk long distance",
          "price": 1500
        },
        {
          "code": "WCHC",
          "label": "Cabin Wheelchair",
          "price": 0
        },
        "… 10 more (open the viewer)"
      ]
    },
    {
      "journey_index": 1,
      "segment_index": 1,
      "items": [
        {
          "code": "PVIP",
          "label": "Xpress Ahead- Prebook",
          "price": 600
        },
        {
          "code": "MKFR",
          "label": "Unused Iitnerary",
          "price": 0
        },
        {
          "code": "GUNS",
          "label": "Guns handling fee",
          "price": 5500
        },
        "… 9 more (open the viewer)"
      ]
    }
  ],
  "errors": [
    "add-ons on BOM_DEL_IX_1163 dropped: not a flight of this itinerary",
    "add-ons on BOM_DEL_IX_1163 dropped: not a flight of this itinerary"
  ]
}

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

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-map602 seats

What this step returned: 602 seats(click to expand)

3 flight(s) with a seat map of 3 in the itinerary: (journey 0, segment 0) Airbus A32Y, 232 seats; (journey 1, segment 0) 7M8, 184 seats; (journey 1, segment 1) 32N, 186 seats
602 seats available of 602; free: 16; paid: 586 (from 300 to 1,700)
Window 195, aisle 202, middle 202; exit row 22; extra leg room 36; infant allowed 0

Request body

HTTP 200 · 3590 ms · complete request body (collapsible viewer)

{
  "itinerary_id": "e33a765e-a35e-4ee7-a72b-cf59d64e2eba"
}

HTTP 200 · 3590 ms · complete response body (collapsible viewer)

{
  "itinerary_id": "e33a765e-a35e-4ee7-a72b-cf59d64e2eba",
  "segments": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "airline_code": "IX",
      "flight_number": "1463",
      "from": "DEL",
      "to": "NMI"
    },
    {
      "journey_index": 1,
      "segment_index": 0,
      "airline_code": "IX",
      "flight_number": "1163",
      "from": "BOM",
      "to": "GOX"
    },
    {
      "journey_index": 1,
      "segment_index": 1,
      "airline_code": "IX",
      "flight_number": "2764",
      "from": "GOX",
      "to": "DEL"
    }
  ],
  "seats": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "aircraft_type": "Airbus A32Y",
      "seats": [
        {
          "aisle": false,
          "amount": 1700,
          "code": "RA002831976283552470028339001309RUOIHE8BAWI|6265",
          "column": 1,
          "desc": "1A",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": false,
          "middle": false,
          "near_wings": false,
          "reclining": false,
          "row": 9,
          "tax": 0,
          "window": true
        },
        {
          "aisle": false,
          "amount": 1700,
          "code": "RA002831976283552470028339001309RUOIHE8BAWI|6266",
          "column": 2,
          "desc": "1B",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": false,
          "middle": true,
          "near_wings": false,
          "reclining": false,
          "row": 9,
          "tax": 0,
          "window": false
        },
        {
          "aisle": true,
          "amount": 1700,
          "code": "RA002831976283552470028339001309RUOIHE8BAWI|6267",
          "column": 3,
          "desc": "1C",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": false,
          "middle": false,
          "near_wings": false,
          "reclining": false,
          "row": 9,
          "tax": 0,
          "window": false
        },
        "… 229 more (open the viewer)"
      ],
      "total_seats": 232
    },
    {
      "journey_index": 1,
      "segment_index": 0,
      "aircraft_type": "7M8",
      "seats": [
        {
          "aisle": false,
          "amount": 1700,
          "code": "WINDOW",
          "column": 1,
          "desc": "1A",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": true,
          "middle": false,
          "near_wings": false,
          "reclining": false,
          "row": 1,
          "tax": 80,
          "window": true
        },
        {
          "aisle": false,
          "amount": 1700,
          "code": "MIDDLE",
          "column": 2,
          "desc": "1B",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": true,
          "middle": true,
          "near_wings": false,
          "reclining": false,
          "row": 1,
          "tax": 80,
          "window": false
        },
        {
          "aisle": true,
          "amount": 1700,
          "code": "AISLE",
          "column": 3,
          "desc": "1C",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": true,
          "middle": false,
          "near_wings": false,
          "reclining": false,
          "row": 1,
          "tax": 80,
          "window": false
        },
        "… 181 more (open the viewer)"
      ],
      "total_seats": 184
    },
    {
      "journey_index": 1,
      "segment_index": 1,
      "aircraft_type": "32N",
      "seats": [
        {
          "aisle": false,
          "amount": 1700,
          "code": "WINDOW",
          "column": 1,
          "desc": "1A",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": true,
          "middle": false,
          "near_wings": false,
          "reclining": false,
          "row": 1,
          "tax": 80,
          "window": true
        },
        {
          "aisle": false,
          "amount": 1700,
          "code": "MIDDLE",
          "column": 2,
          "desc": "1B",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": true,
          "middle": true,
          "near_wings": false,
          "reclining": false,
          "row": 1,
          "tax": 80,
          "window": false
        },
        {
          "aisle": true,
          "amount": 1700,
          "code": "AISLE",
          "column": 3,
          "desc": "1C",
          "exit_row": false,
          "infant": false,
          "is_available": true,
          "leg_room": true,
          "middle": false,
          "near_wings": false,
          "reclining": false,
          "row": 1,
          "tax": 80,
          "window": false
        },
        "… 183 more (open the viewer)"
      ],
      "total_seats": 186
    }
  ]
}

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

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
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 AIOR432493, amount 5,743, pay_till given
GST details sent: no; ancillaries selected: 0

Request body

HTTP 200 · 13351 ms · complete request body (collapsible viewer)

{
  "itinerary_id": "e33a765e-a35e-4ee7-a72b-cf59d64e2eba",
  "is_hold": true,
  "pax_details": [
    {
      "first_name": "Rohan",
      "last_name": "Pillai",
      "pax_type": "ADULT",
      "title": "Mr",
      "gender": "male",
      "dob": "1990-05-12",
      "phone": "9876543210",
      "email": "rohan.verma@example.com"
    }
  ]
}

HTTP 200 · 13351 ms · complete response body (collapsible viewer)

{
  "booking_id": "AIOR432493",
  "itinerary_id": "e33a765e-a35e-4ee7-a72b-cf59d64e2eba",
  "status": "ONHOLD",
  "amount": 5742.94,
  "pay_till": "2026-10-21T03:28: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

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 1463 DEL-NMI
passenger 0 ADULT Rohan: CONFIRMED, PNR SYJBUE, ticket BX21HJ00071-1, fare Value X/XNRA015, total 3,002, net 3,002, baggage hand 7kg, checkin 15kg
Journey 1 BOM-DEL: segment 0 IX 1163 BOM-GOX; segment 1 IX 2764 GOX-DEL
passenger 0 ADULT Rohan: CONFIRMED, PNR SZGN3C, ticket BX21HJ00071-1, fare Value EC/XNRA015, total 2,741, net 2,741, baggage hand 7kg, checkin 15kg
PNR on 2 of 2 passenger-journeys; 1 passenger(s): ADULT Rohan Pillai
Booking price: base 1,900, yq 1,700, other taxes 385, total 5,743, net 5,743

Request body

HTTP 200 · 117 ms · complete request body (collapsible viewer)

{
  "booking_id": "AIOR432493"
}

HTTP 200 · 117 ms · complete response body (collapsible viewer)

{
  "booking_id": "AIOR432493",
  "status": "ONHOLD",
  "payment_status": "PENDING",
  "created_at": "2026-10-21T00:28:35Z",
  "pay_till": "2026-10-21T03:28:00Z",
  "route_type": "DOMESTIC",
  "journeys": [
    {
      "journey_index": 0,
      "from": "DEL",
      "to": "NMI",
      "departure_time": "2026-11-20T06:00",
      "arrival_time": "2026-11-20T08:05",
      "segments": [
        {
          "segment_index": 0,
          "from": "DEL",
          "to": "NMI",
          "airline_code": "IX",
          "airline_name": "Air India Express",
          "flight_number": "1463",
          "departure_time": "2026-11-20T06:00",
          "arrival_time": "2026-11-20T08:05",
          "departure_terminal": "1",
          "duration": 125
        }
      ],
      "passengers": [
        {
          "passenger_index": 0,
          "first_name": "Rohan",
          "last_name": "Pillai",
          "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": "SYJBUE",
          "ticket_number": "BX21HJ00071-1",
          "fare_ref": "Value",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "X",
          "fare_basis": "XNRA015",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          }
        }
      ]
    },
    {
      "journey_index": 1,
      "from": "BOM",
      "to": "DEL",
      "departure_time": "2026-11-25T20:00",
      "arrival_time": "2026-11-26T00:25",
      "segments": [
        {
          "segment_index": 0,
          "from": "BOM",
          "to": "GOX",
          "airline_code": "IX",
          "airline_name": "Air India Express",
          "flight_number": "1163",
          "departure_time": "2026-11-25T20:00",
          "arrival_time": "2026-11-25T21:25",
          "departure_terminal": "2",
          "duration": 85
        },
        {
          "segment_index": 1,
          "from": "GOX",
          "to": "DEL",
          "airline_code": "IX",
          "airline_name": "Air India Express",
          "flight_number": "2764",
          "departure_time": "2026-11-25T21:45",
          "arrival_time": "2026-11-26T00:25",
          "arrival_terminal": "1",
          "duration": 160
        }
      ],
      "passengers": [
        {
          "passenger_index": 0,
          "first_name": "Rohan",
          "last_name": "Pillai",
          "pax_type": "ADULT",
          "title": "Mr",
          "gender": "male",
          "dob": "1990-05-12",
          "fare": {
            "base_fare": 1001,
            "yq": 850,
            "airline_gst": 106,
            "booking_fee": 100,
            "other_taxes": 66,
            "total_fare": 2741,
            "net_fare": 2741
          },
          "status": "CONFIRMED",
          "pnr": "SZGN3C",
          "ticket_number": "BX21HJ00071-1",
          "fare_ref": "Value",
          "cabin_class": "Economy",
          "booking_class": "EC",
          "fare_basis": "XNRA015",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          }
        }
      ]
    }
  ],
  "price": {
    "base_fare": 1900,
    "yq": 1700,
    "airline_gst": 202,
    "booking_fee": 200,
    "other_taxes": 385,
    "agent_markup": 100,
    "total_fare": 5742.94,
    "net_fare": 5742.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

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/release1 released

What this step returned: 1 released(click to expand)

Status after release: PNR_RELEASED

Request body

HTTP 200 · 1869 ms · complete request body (collapsible viewer)

{
  "booking_id": "AIOR432493"
}

HTTP 200 · 1869 ms · complete response body (collapsible viewer)

{
  "booking_id": "AIOR432493",
  "status": "PNR_RELEASED",
  "pnr": "SZGN3C"
}

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

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.