search

Admitted input schema

{
  "type": "object",
  "properties": {
    "adults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9,
      "description": "1 to 9. The offer is priced for this many travellers and /air/book must supply exactly this many passengers, lead first."
    },
    "cabin_class": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Optional, defaults to economy."
    },
    "cheapest_per_itinerary": {
      "type": "boolean",
      "description": "Optional. Collapse each physical itinerary (comparison_key) to its cheapest fare; fare_options_count reports how many fares were folded. Drill into a finalist with POST /air/offer-details."
    },
    "depart_date": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "format": "date"
    },
    "departure_after": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
      "description": "Optional. Outbound departs at or after this local time (HH:MM)."
    },
    "departure_before": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
      "description": "Optional. Outbound departs at or before this local time (HH:MM). Combine both for a window: afternoon = after 12:00 before 18:00."
    },
    "destination_iata": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Destination IATA code."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Optional. Cap the number of offers returned, cheapest first. Full responses can exceed 300 KB — LLM agents should combine this with cheapest_per_itinerary."
    },
    "max_price": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional decimal cap on total_amount, e.g. \"250.00\"."
    },
    "max_stops": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Optional. Maximum plane changes per direction; 0 = direct only."
    },
    "origin_iata": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Origin IATA code."
    },
    "return_date": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "format": "date",
      "description": "Optional. Adds the inbound (destination back to origin); round-trip offers book both directions in one /air/book."
    },
    "sort": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "price",
        "duration",
        "departure",
        "emissions"
      ],
      "description": "Optional ordering, ascending. Default price."
    }
  },
  "required": [
    "origin_iata",
    "destination_iata",
    "depart_date",
    "adults"
  ],
  "additionalProperties": false
}