Reference

{
  "api_key": "ak_3f2e1d0c9b8a7f6e5d4c3b2a1f0e9d8c"
}

{
  "token": "<token>",
  "token_type": "Bearer",
  "expires_in": 14400,
  "expires_at": "2026-10-16T10:12:00Z"
}

{
  "segments": [
    {
      "from": "BLR",
      "to": "BOM",
      "date": "2026-11-14"
    }
  ],
  "adult": 1,
  "child": 0,
  "infant": 0,
  "cabin_class": 1,
  "fare_types": [
    1
  ],
  "direct_flight": false,
  "preferred_airlines": [
    "QP"
  ],
  "detail": "journey",
  "include_fare_rules": true
}

• detail: journey (default) = one set of fare attributes per fare option; segment = also segments[] inside each fare option, one entry per flight. Any other value is a 400 (field detail, rule one_of).
• include_fare_rules: default true; false leaves fare_rules out of the reply and off every fare.
• segments: 1 to 6 legs; a return trip is two segments. date is YYYY-MM-DD.
• adult 1-9 (required), child 0-9, infant 0-9.
• cabin_class: 1 economy, 2 premium economy, 3 business, 4 first; 0 or absent = no filter.
• fare_types: 1 regular, 2 student, 3 senior citizen, 4 doctor/nurse, 5 armed forces; absent = regular.

{
  "search_id": "a1d2c3b4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "status": "completed",
  "valid_till": "2026-10-18T21:12:00+05:30",
  "fare_rules": {
    "fr_1": {
      "cancellation": [
        {
          "allowed": false,
          "from": {
            "value": 0,
            "unit": "HOURS"
          },
          "to": {
            "value": 3,
            "unit": "HOURS"
          },
          "text": "Non-refundable within 3 hours of departure"
        },
        {
          "allowed": true,
          "amount": 3899,
          "from": {
            "value": 3,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          }
        }
      ],
      "date_change": [
        {
          "allowed": true,
          "amount": 2999,
          "from": {
            "value": 3,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          }
        }
      ]
    }
  },
  "results": [
    {
      "journey_indexes": [
        0
      ],
      "options": [
        {
          "option_id": "3f9e8d7c-6b5a-4f3e-9d2c-1b0a9f8e7d6c",
          "segments": [
            {
              "segment_index": 0,
              "journey_index": 0,
              "segment_id": "BLR_BOM_QP_1101",
              "from": "BLR",
              "to": "BOM",
              "airline_code": "QP",
              "airline_name": "Akasa Air",
              "aircraft_type": "737 MAX 8",
              "flight_number": "1101",
              "departure_time": "2026-11-14T06:00:00",
              "departure_terminal": "1",
              "arrival_time": "2026-11-14T07:45:00",
              "arrival_terminal": "2",
              "duration": 105
            }
          ],
          "fare_options": [
            {
              "price_id": "7c1b2f3e-9a4d-4c2e-8f1a-2b3c4d5e6f70",
              "fare_rules": {
                "0": "fr_1"
              },
              "adult": {
                "fare_ref": "SAVER",
                "refundable_type": "PARTIALLY_REFUNDABLE",
                "cabin_class": "Economy",
                "booking_class": "Q",
                "fare_basis": "QPSAVER",
                "baggage": {
                  "hand": {
                    "kg": 7
                  },
                  "checkin": {
                    "kg": 15
                  }
                },
                "fare": {
                  "hand_baggage": "7Kg",
                  "checkin_baggage": "15Kg",
                  "base_fare": 4200,
                  "yq": 0,
                  "yr": 0,
                  "airline_gst": 0,
                  "booking_fee": 0,
                  "commission": 0,
                  "other_taxes": 812,
                  "total_fare": 5012,
                  "net_fare": 5012,
                  "pax_count": 1
                }
              },
              "varies_by_segment": false
            }
          ]
        }
      ]
    }
  ]
}

• results[] groups options by the journey indexes their fares cover: one way = one group [0]; a return sold per direction = groups [0] and [1]; a combined return fare = one group [0, 1]. Pick one option and one fare per group until every requested journey is covered.
• option_id identifies the flights, price_id the fare on them; both go to /flights/reprice. Ids are valid until valid_till (60 minutes).
• A fare prices the whole option: one object per requested passenger type (adult, child, infant), each with its fare (base, taxes, total, net, pax_count), booking_class, fare_basis and baggage. No amount appears anywhere else, never inside segments[].
• Segment view (detail=segment): segments[] on every fare, one entry per flight matched by segment_index, same fields per flight.
• fare_rules on a fare maps each journey index to an id (fr_1, fr_2, …) in the top-level fare_rules; a missing index has no rule known at search. Ids mean nothing outside this reply.
• Baggage is {kg} and/or {pieces}; absent = not included or not known. Flight segments carry airport codes only (from, to).
• Times are local to the airport, format YYYY-MM-DDTHH:MM:SS, no zone; valid_till carries its offset.
• A missing field is zero, false or not applicable. The reply has no $schema field.

{
  "items": [
    {
      "option_id": "3f9e8d7c-6b5a-4f3e-9d2c-1b0a9f8e7d6c",
      "price_id": "7c1b2f3e-9a4d-4c2e-8f1a-2b3c4d5e6f70"
    }
  ]
}

• items: one entry per fare; a return sold as two one-way fares sends two items. option_id and price_id at top level are accepted for a single fare.

{
  "itinerary_id": "9b8a7f6e-5d4c-4b3a-2f1e-0d9c8b7a6f5e",
  "valid_till": "2026-10-18T20:27:00+05:30",
  "fare_rules": {
    "fr_1": {
      "cancellation": [
        {
          "allowed": false,
          "from": {
            "value": 0,
            "unit": "HOURS"
          },
          "to": {
            "value": 3,
            "unit": "HOURS"
          },
          "text": "Non-refundable within 3 hours of departure"
        },
        {
          "allowed": true,
          "amount": 3899,
          "from": {
            "value": 3,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          }
        }
      ],
      "date_change": [
        {
          "allowed": true,
          "amount": 2999,
          "from": {
            "value": 3,
            "unit": "HOURS"
          },
          "to": {
            "value": 365,
            "unit": "DAYS"
          }
        }
      ]
    }
  },
  "results": [
    {
      "journey_indexes": [
        0
      ],
      "option_id": "3f9e8d7c-6b5a-4f3e-9d2c-1b0a9f8e7d6c",
      "segments": [
        {
          "segment_index": 0,
          "journey_index": 0,
          "segment_id": "BLR_BOM_QP_1101",
          "from": "BLR",
          "to": "BOM",
          "airline_code": "QP",
          "airline_name": "Akasa Air",
          "aircraft_type": "737 MAX 8",
          "flight_number": "1101",
          "departure_time": "2026-11-14T06:00:00",
          "departure_terminal": "1",
          "arrival_time": "2026-11-14T07:45:00",
          "arrival_terminal": "2",
          "duration": 105
        }
      ],
      "fare": {
        "price_id": "7c1b2f3e-9a4d-4c2e-8f1a-2b3c4d5e6f70",
        "fare_rules": {
          "0": "fr_1"
        },
        "adult": {
          "fare_ref": "SAVER",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "Q",
          "fare_basis": "QPSAVER",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          },
          "fare": {
            "hand_baggage": "7Kg",
            "checkin_baggage": "15Kg",
            "base_fare": 4200,
            "yq": 0,
            "yr": 0,
            "airline_gst": 0,
            "booking_fee": 0,
            "commission": 0,
            "other_taxes": 812,
            "total_fare": 5012,
            "net_fare": 5012,
            "pax_count": 1
          }
        },
        "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": 30,
    "lastname_length": 30,
    "firstname_min_length": 2,
    "lastname_min_length": 2,
    "seat_mandatory": false,
    "meal_mandatory": false,
    "baggage_mandatory": false
  },
  "price": {
    "adult": {
      "hand_baggage": "7Kg",
      "checkin_baggage": "15Kg",
      "base_fare": 4200,
      "yq": 0,
      "yr": 0,
      "airline_gst": 0,
      "booking_fee": 0,
      "commission": 0,
      "other_taxes": 812,
      "total_fare": 5012,
      "net_fare": 5012,
      "pax_count": 1
    },
    "total": {
      "hand_baggage": "7Kg",
      "checkin_baggage": "15Kg",
      "base_fare": 4200,
      "yq": 0,
      "yr": 0,
      "airline_gst": 0,
      "booking_fee": 0,
      "commission": 0,
      "other_taxes": 812,
      "total_fare": 5012,
      "net_fare": 5012,
      "pax_count": 1
    }
  },
  "messages": [
    {
      "type": "FARE_ALERT",
      "option_id": "3f9e8d7c-6b5a-4f3e-9d2c-1b0a9f8e7d6c",
      "message": "Fare has changed: previous price 5012.00, current price 5112.00 (difference: 100.00)",
      "old_value": 5012,
      "new_value": 5112
    }
  ]
}

• booking_requirements.is_hold says whether POST /flights/book may be called with is_hold true; the other fields say what the booking must carry (GST, PAN, passport, dates of birth, name lengths, mandatory seat, meal or bag).
• results[] has one entry per item sent: the option's flights and the one fare, priced again, in the fare shape of search (detail=segment adds segments[] inside fare). fare_rules holds the rules those fares point at.
• valid_till is when the supplier's session for this itinerary ends (the API's review session, default 15 minutes); book before it.
• messages is absent when nothing changed; otherwise one entry per repriced option with type FARE_ALERT, the option_id, and the old and new value.

{
  "itinerary_id": "9b8a7f6e-5d4c-4b3a-2f1e-0d9c8b7a6f5e"
}

{
  "itinerary_id": "9b8a7f6e-5d4c-4b3a-2f1e-0d9c8b7a6f5e",
  "segments": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "airline_code": "QP",
      "flight_number": "1101",
      "from": "BLR",
      "to": "BOM"
    }
  ],
  "baggage": [
    {
      "journey_index": 0,
      "items": [
        {
          "code": "XBAG05",
          "label": "Extra 5 Kg",
          "price": 1500
        }
      ]
    }
  ],
  "meal": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "items": [
        {
          "code": "VGML",
          "label": "Vegetarian meal",
          "price": 350
        }
      ]
    }
  ],
  "other": []
}

• segments[] repeats the itinerary's flights, each named by (journey_index, segment_index) as in search and reprice; segment_index restarts at 0 inside every journey.
• Bags are sold per journey: baggage[] has one entry per journey. Meals and other items are sold per flight: meal[] and other[] have one entry per flight. A journey or flight absent from a bucket offers nothing of that type.
• On book, send a bag with its code and journey_index; a meal, other item or seat with its code, journey_index and segment_index.
• errors[] (plain strings) appears when one flight's catalogue failed; the rest is still returned.

{
  "itinerary_id": "9b8a7f6e-5d4c-4b3a-2f1e-0d9c8b7a6f5e"
}

{
  "itinerary_id": "9b8a7f6e-5d4c-4b3a-2f1e-0d9c8b7a6f5e",
  "segments": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "airline_code": "QP",
      "flight_number": "1101",
      "from": "BLR",
      "to": "BOM"
    }
  ],
  "seats": [
    {
      "journey_index": 0,
      "segment_index": 0,
      "aircraft_type": "737 MAX 8",
      "total_seats": 189,
      "seats": [
        {
          "aisle": false,
          "amount": 600,
          "code": "WINDOW",
          "column": 1,
          "desc": "1A",
          "exit_row": false,
          "infant": true,
          "is_available": true,
          "leg_room": true,
          "middle": false,
          "near_wings": false,
          "reclining": true,
          "row": 1,
          "tax": 0,
          "window": true
        }
      ]
    }
  ]
}

• segments[] as in ancillaries; each seats block names its flight by (journey_index, segment_index). desc is the seat label (1A) that goes into the booking; code is the seat type.

{
  "itinerary_id": "9b8a7f6e-5d4c-4b3a-2f1e-0d9c8b7a6f5e",
  "is_hold": false,
  "gst_details": {
    "name": "Example Travels Pvt Ltd",
    "number": "27AABCE1234F1Z5",
    "address": "12 MG Road, Mumbai 400001",
    "email": "accounts@example.com",
    "mobile": "+919876543210"
  },
  "pax_details": [
    {
      "first_name": "Rahul",
      "last_name": "Sharma",
      "pax_type": "ADULT",
      "title": "Mr",
      "gender": "male",
      "dob": "1990-05-12",
      "phone": "+919876543210",
      "email": "rahul.sharma@example.com",
      "passport_details": {
        "passport_number": "Z1234567",
        "passport_issue_date": "2022-01-10",
        "passport_expiry_date": "2032-01-09",
        "passport_issue_country": "IN",
        "nationality": "IN"
      },
      "ancillaries": {
        "seat": [
          {
            "code": "1A",
            "price": 600,
            "label": "window",
            "journey_index": 0,
            "segment_index": 0
          }
        ],
        "baggage": [
          {
            "code": "XBAG05",
            "price": 1500,
            "label": "Extra 5 Kg",
            "journey_index": 0
          }
        ],
        "meal": [],
        "other": []
      }
    }
  ]
}

• pax_details: one per traveller, at least one. pax_type ADULT, CHILD or INFANT; title Mr, Mrs, Ms, Mstr, Miss; gender male or female; dates YYYY-MM-DD (values as the web frontend sends them; the validator names are passenger_type, passenger_title, gender, dateformat).
• phone and email are required on every passenger; the first passenger's pair is stored as the customer contact.
• gst_details is optional as a block; when present, all five fields are required and number must be a valid GSTIN.
• passport_details is optional; send it when review's requirements say passport_applicable.

{
  "booking_id": "AIOR482913",
  "itinerary_id": "9b8a7f6e-5d4c-4b3a-2f1e-0d9c8b7a6f5e",
  "status": "SUCCESS",
  "amount": 7112
}

{
  "booking_id": "AIOR482914",
  "itinerary_id": "9b8a7f6e-5d4c-4b3a-2f1e-0d9c8b7a6f5e",
  "status": "ONHOLD",
  "amount": 7112,
  "pay_till": "2026-10-17T10:12:00Z"
}

• status is the payment status for a paid booking (SUCCESS; PENDING when the ticket is not yet issued) and ONHOLD for a hold.

{
  "booking_id": "AIOR482913"
}

{
  "booking_id": "AIOR482913",
  "status": "SUCCESS",
  "payment_status": "SUCCESS",
  "created_at": "2026-10-15T10:12:34Z",
  "route_type": "DOMESTIC",
  "journeys": [
    {
      "journey_index": 0,
      "from": "BLR",
      "to": "BOM",
      "departure_time": "2026-11-14T06:00:00",
      "arrival_time": "2026-11-14T07:45:00",
      "segments": [
        {
          "segment_index": 0,
          "from": "BLR",
          "to": "BOM",
          "airline_code": "QP",
          "airline_name": "Akasa Air",
          "flight_number": "1101",
          "departure_time": "2026-11-14T06:00:00",
          "arrival_time": "2026-11-14T07:45:00",
          "departure_terminal": "1",
          "arrival_terminal": "2",
          "duration": 105
        }
      ],
      "passengers": [
        {
          "passenger_index": 0,
          "first_name": "Rahul",
          "last_name": "Sharma",
          "pax_type": "ADULT",
          "title": "Mr",
          "gender": "male",
          "dob": "1990-05-12",
          "passport_details": {
            "passport_number": "Z1234567",
            "passport_issue_date": "2022-01-10",
            "passport_expiry_date": "2032-01-09",
            "nationality": "IN"
          },
          "fare": {
            "base_fare": 4200,
            "yq": 500,
            "other_taxes": 312,
            "ancillaries": 2100,
            "total_fare": 7112,
            "net_fare": 7112
          },
          "status": "CONFIRMED",
          "pnr": "H7K2PQ",
          "ticket_number": "",
          "fare_ref": "SAVER",
          "refundable_type": "PARTIALLY_REFUNDABLE",
          "cabin_class": "Economy",
          "booking_class": "Q",
          "fare_basis": "QPSAVER",
          "baggage": {
            "hand": {
              "kg": 7
            },
            "checkin": {
              "kg": 15
            }
          },
          "ancillaries": {
            "seat": [
              {
                "code": "1A",
                "price": 600,
                "label": "window",
                "segment_index": 0
              }
            ],
            "baggage": [
              {
                "code": "XBAG05",
                "price": 1500,
                "label": "Extra 5 Kg"
              }
            ]
          }
        }
      ]
    }
  ],
  "price": {
    "base_fare": 4200,
    "yq": 500,
    "other_taxes": 312,
    "ancillaries": 2100,
    "total_fare": 7112,
    "net_fare": 7112
  },
  "gst_details": {
    "name": "Example Travels Pvt Ltd",
    "number": "27AABCE1234F1Z5",
    "address": "12 MG Road, Mumbai 400001",
    "email": "accounts@example.com",
    "mobile": "+919876543210"
  }
}

• journeys[] is the booking journey by journey: its dates, its flights (segment_index restarts at 0 inside each journey; operating airline shown only on a codeshare) and, for every passenger on it, who they are (passenger_index is the same person on every journey), the status, the PNR, the ticket number, the fare paid for that journey in the components of the search price plus ancillaries, the fare attributes (fare_ref, refundable_type, cabin, booking class, fare basis, included baggage) and the ancillaries bought (a seat or meal with its segment_index, a bag without).
• status per passenger per journey is PENDING until the booking is held or ticketed, then CONFIRMED; CANCELLED, VOIDED or REISSUED come later. price is the booking as a whole in the same components, total_fare and net_fare included.
• pay_till appears on a held booking. Zero fare fields are omitted (omitempty).
• status values are the API's order statuses: CREATED, PENDING, SUCCESS, ONHOLD, FAILED, PNR_RELEASED, CANCELLED, ABORTED.

{
  "booking_id": "AIOR482914"
}

{
  "booking_id": "AIOR482914",
  "itinerary_id": "9b8a7f6e-5d4c-4b3a-2f1e-0d9c8b7a6f5e",
  "status": "SUCCESS",
  "amount": 7112
}

{
  "booking_id": "AIOR482914"
}

{
  "booking_id": "AIOR482914",
  "status": "PNR_RELEASED",
  "pnr": "H7K2PQ"
}

• success is false when every provider release failed; status then stays as it was.