Fare Deals

{
  "type": "object",
  "required": [
    "from"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "City or airport, or anywhere (default). Same state or country hints as from."
    },
    "from": {
      "type": "string",
      "description": "City or airport, for example New York or JFK. Add a state or country when a name is shared: Birmingham, UK; Birmingham, AL; Portland, Maine."
    },
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "How many deals to return, 1 to 20."
    },
    "month": {
      "type": "string",
      "description": "Departure month 2026-11 or date 2026-11-14."
    },
    "return": {
      "type": "string",
      "description": "Return month or date."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country for the currency, for example US, GB, CA, AU, DE. Leave out to use the traveller's location."
    },
    "nonstop": {
      "type": "boolean",
      "description": "True for direct flights only."
    },
    "one_way": {
      "type": "boolean",
      "description": "True for one-way fares only."
    },
    "max_price": {
      "type": "number",
      "description": "Budget in US dollars."
    }
  },
  "additionalProperties": false
}