a2bflight fares

{'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'destination IATA airport or city code'}, 'from': {'type': 'string', 'description': 'origin IATA airport or city code (NYC covers JFK, LGA and EWR); give from, to or both'}, 'limit': {'type': 'integer', 'description': 'how many routes to return, 1 to 20; 10 when omitted'}, 'month': {'type': 'string', 'description': 'YYYY-MM: the cheapest fare departing in that month; needs from'}, 'max_price': {'type': 'number', 'description': 'keep only fares at or under this amount, in the currency the results carry'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['routes'], 'properties': {'note': {'type': 'string'}, 'routes': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'return': {'type': ['null', 'object'], 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'description': "the route's cheapest round trip of a 3 to 21 day stay; absent when we hold none, and the route's page_url then offers a live return search", 'additionalProperties': False}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'additionalProperties': False}}, 'currency': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'near': {'type': 'string', 'description': 'an IATA code, or lat,lon, to list the airports near it; give this or query'}, 'query': {'type': 'string', 'description': 'a city or airport name or the start of one; give this or near'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['places'], 'properties': {'places': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['code', 'city', 'country'], 'properties': {'city': {'type': 'string'}, 'code': {'type': 'string'}, 'metro': {'type': 'boolean', 'description': 'true for a city code that covers several airports'}, 'country': {'type': 'string'}, 'airports': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'distance_km': {'type': ['null', 'integer']}}, 'additionalProperties': False}}}, 'additionalProperties': False}

{'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'destination IATA airport code'}, 'from': {'type': 'string', 'description': 'origin IATA airport code (an airport, not a city code)'}, 'month': {'type': 'string', 'description': 'YYYY-MM: keep only departure dates in that month'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['from', 'to', 'status', 'page_url'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'dates': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'the cheapest one-way fares by departure date, cheapest first'}, 'months': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'the cheapest one-way fare in each month'}, 'status': {'type': 'string', 'description': 'held: fares below; pricing: we just started pricing this route, ask again in a minute; none: we hold no fare for it'}, 'returns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'the cheapest round trips held, any stay, cheapest first'}, 'cheapest': {'type': ['null', 'object'], 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'description': 'the cheapest one-way', 'additionalProperties': False}, 'currency': {'type': 'string'}, 'page_url': {'type': 'string'}, 'cheapest_return': {'type': ['null', 'object'], 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'description': 'the cheapest round trip of a 3 to 21 day stay; absent when we hold none, and page_url then offers a live return search', 'additionalProperties': False}}, 'additionalProperties': False}