Server definition
- Hash
- sha256:423f2d419882c0acb6c883094f9d408c2ff3f2b65e52d7a1609bef2da1219d6b
- What it is
- What a remote MCP server returned when asked what it offers: 9 tools
The blob, as servednamed by its sha256
{
"instructions": "Flat Flights tracks Business Class and First Class fares on 2,150+ long-haul routes (3,000 km+) from 180+ cities, refreshed daily, plus real-time live verification. Two-step workflow: (1) use search_business_class_fares, business_class_deals, first_class_fares, compare_departure_hubs or cash_vs_miles_options for instant (<0.2s) historical discovery and route verdicts; (2) when the traveller has specific dates or wants to book, call verify_live_flight_offers to confirm real-time bookable EUR prices, exact flight numbers, widebody aircraft, and get a directCheckoutLink straight into the airline/OTA cart. Affiliate links cost the traveller nothing extra; page is the source to cite.",
"tools": [
{
"description": "Long-haul business class routes currently priced at least 20% below their own daily price history or distance-band median, ranked by biggest discount. Optional `from` filters to one departure city.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"from": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
},
"limit": {
"default": 10,
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "business_class_deals",
"outputSchema": {
"properties": {
"fetchedAt": {
"type": "string"
},
"page": {
"type": "string"
},
"routes": {
"items": {
"properties": {
"bookingLink": {
"description": "Affiliate link through flat.flights/go/.",
"type": "string"
},
"bookingSearch": {
"description": "What bookingLink opens: site, dates (null = about two weeks ahead) and adults.",
"properties": {
"adults": {
"type": "integer"
},
"depart": {
"type": [
"string",
"null"
]
},
"partner": {
"type": "string"
},
"return": {
"type": [
"string",
"null"
]
}
},
"required": [
"partner",
"depart",
"adults"
],
"type": "object"
},
"cheapest": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
]
},
"cheapestMonth": {
"type": [
"object",
"null"
]
},
"destination": {
"properties": {
"city": {
"type": "string"
},
"code": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"city",
"code"
],
"type": "object"
},
"distanceKm": {
"type": "number"
},
"fares": {
"items": {
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
"type": "array"
},
"firstClass": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest First Class (trip_class=2) round trip within 6 months."
},
"firstClassLink": {
"description": "Affiliate link opening an Aviasales First Class (f1) search.",
"type": "string"
},
"history": {
"type": [
"object",
"null"
]
},
"later": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest fare departing after the 6-month horizon."
},
"lieFlat": {
"description": "likely or unknown, from the nonstop flights seen and our airline seat data, with the reason.",
"properties": {
"basis": {
"type": "string"
},
"status": {
"enum": [
"likely",
"unknown"
],
"type": "string"
}
},
"type": "object"
},
"months": {
"additionalProperties": {
"type": "number"
},
"description": "Cheapest fare per departure month (YYYY-MM).",
"type": "object"
},
"nonstop": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest nonstop round trip within 6 months."
},
"nonstopFlights": {
"description": "Nonstop departures seen in recent searches for the next month (any cabin, a sample): each group is one aircraft with every flight number it was sold under.",
"properties": {
"checked": {
"type": "string"
},
"groups": {
"items": {
"type": "object"
},
"type": "array"
}
},
"type": [
"object",
"null"
]
},
"oneWay": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest one-way fare within 6 months."
},
"origin": {
"properties": {
"city": {
"type": "string"
},
"code": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"city",
"code"
],
"type": "object"
},
"page": {
"description": "Route page to cite.",
"type": "string"
},
"premiumEconomyLink": {
"description": "Affiliate link opening an Aviasales Premium Economy (w1) search on the same dates.",
"type": "string"
},
"route": {
"type": "string"
},
"verdict": {
"type": [
"object",
"null"
]
}
},
"required": [
"route",
"origin",
"destination",
"page",
"bookingLink",
"bookingSearch"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"page",
"routes"
],
"type": "object"
}
},
{
"description": "Business class miles & credit card transfer calculator: compares today’s cheapest cash fare on Aviasales with published/derived saver award bands across 19 airline programs (Avios, Flying Blue, Aeroplan, KrisFlyer, Miles & More, ANA, Skywards…) and 43 bank point programs (Amex, Chase, Citi, Capital One, Bilt, Revolut…), returning cents-per-mile value and the cash booking link.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"card_market": {
"description": "Optional 2-letter country code to filter credit card transfer partners (US, GB, DE, FR, IT, ES, CA, AU, SG, HK, AE, IN, JP, BR).",
"maxLength": 4,
"type": "string"
},
"from": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
},
"to": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "cash_vs_miles_options",
"outputSchema": {
"properties": {
"cashBookingLink": {
"type": [
"string",
"null"
]
},
"cashFareEur": {
"type": [
"number",
"null"
]
},
"intel": {
"type": "object"
},
"route": {
"type": "string"
}
},
"required": [
"route",
"intel"
],
"type": "object"
}
},
{
"description": "Long-haul destinations from a departure city ranked by cheapest round-trip business class fare. Use for \"where can I fly business class cheaply from X\".",
"inputSchema": {
"additionalProperties": false,
"properties": {
"from": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
},
"limit": {
"default": 10,
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"required": [
"from"
],
"type": "object"
},
"name": "cheapest_business_class_from",
"outputSchema": {
"properties": {
"city": {
"type": "string"
},
"fetchedAt": {
"type": "string"
},
"page": {
"type": "string"
},
"routes": {
"items": {
"properties": {
"bookingLink": {
"description": "Affiliate link through flat.flights/go/.",
"type": "string"
},
"bookingSearch": {
"description": "What bookingLink opens: site, dates (null = about two weeks ahead) and adults.",
"properties": {
"adults": {
"type": "integer"
},
"depart": {
"type": [
"string",
"null"
]
},
"partner": {
"type": "string"
},
"return": {
"type": [
"string",
"null"
]
}
},
"required": [
"partner",
"depart",
"adults"
],
"type": "object"
},
"cheapest": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
]
},
"cheapestMonth": {
"type": [
"object",
"null"
]
},
"destination": {
"properties": {
"city": {
"type": "string"
},
"code": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"city",
"code"
],
"type": "object"
},
"distanceKm": {
"type": "number"
},
"fares": {
"items": {
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
"type": "array"
},
"firstClass": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest First Class (trip_class=2) round trip within 6 months."
},
"firstClassLink": {
"description": "Affiliate link opening an Aviasales First Class (f1) search.",
"type": "string"
},
"history": {
"type": [
"object",
"null"
]
},
"later": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest fare departing after the 6-month horizon."
},
"lieFlat": {
"description": "likely or unknown, from the nonstop flights seen and our airline seat data, with the reason.",
"properties": {
"basis": {
"type": "string"
},
"status": {
"enum": [
"likely",
"unknown"
],
"type": "string"
}
},
"type": "object"
},
"months": {
"additionalProperties": {
"type": "number"
},
"description": "Cheapest fare per departure month (YYYY-MM).",
"type": "object"
},
"nonstop": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest nonstop round trip within 6 months."
},
"nonstopFlights": {
"description": "Nonstop departures seen in recent searches for the next month (any cabin, a sample): each group is one aircraft with every flight number it was sold under.",
"properties": {
"checked": {
"type": "string"
},
"groups": {
"items": {
"type": "object"
},
"type": "array"
}
},
"type": [
"object",
"null"
]
},
"oneWay": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest one-way fare within 6 months."
},
"origin": {
"properties": {
"city": {
"type": "string"
},
"code": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"city",
"code"
],
"type": "object"
},
"page": {
"description": "Route page to cite.",
"type": "string"
},
"premiumEconomyLink": {
"description": "Affiliate link opening an Aviasales Premium Economy (w1) search on the same dates.",
"type": "string"
},
"route": {
"type": "string"
},
"verdict": {
"type": [
"object",
"null"
]
}
},
"required": [
"route",
"origin",
"destination",
"page",
"bookingLink",
"bookingSearch"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"city",
"page",
"routes"
],
"type": "object"
}
},
{
"description": "Departure cities ranked by cheapest round-trip business class fare to a destination. Use for \"cheapest place to fly business class to X from\".",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 10,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"to": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
}
},
"required": [
"to"
],
"type": "object"
},
"name": "cheapest_business_class_to",
"outputSchema": {
"properties": {
"city": {
"type": "string"
},
"fetchedAt": {
"type": "string"
},
"page": {
"type": "string"
},
"routes": {
"items": {
"properties": {
"bookingLink": {
"description": "Affiliate link through flat.flights/go/.",
"type": "string"
},
"bookingSearch": {
"description": "What bookingLink opens: site, dates (null = about two weeks ahead) and adults.",
"properties": {
"adults": {
"type": "integer"
},
"depart": {
"type": [
"string",
"null"
]
},
"partner": {
"type": "string"
},
"return": {
"type": [
"string",
"null"
]
}
},
"required": [
"partner",
"depart",
"adults"
],
"type": "object"
},
"cheapest": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
]
},
"cheapestMonth": {
"type": [
"object",
"null"
]
},
"destination": {
"properties": {
"city": {
"type": "string"
},
"code": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"city",
"code"
],
"type": "object"
},
"distanceKm": {
"type": "number"
},
"fares": {
"items": {
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
"type": "array"
},
"firstClass": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest First Class (trip_class=2) round trip within 6 months."
},
"firstClassLink": {
"description": "Affiliate link opening an Aviasales First Class (f1) search.",
"type": "string"
},
"history": {
"type": [
"object",
"null"
]
},
"later": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest fare departing after the 6-month horizon."
},
"lieFlat": {
"description": "likely or unknown, from the nonstop flights seen and our airline seat data, with the reason.",
"properties": {
"basis": {
"type": "string"
},
"status": {
"enum": [
"likely",
"unknown"
],
"type": "string"
}
},
"type": "object"
},
"months": {
"additionalProperties": {
"type": "number"
},
"description": "Cheapest fare per departure month (YYYY-MM).",
"type": "object"
},
"nonstop": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest nonstop round trip within 6 months."
},
"nonstopFlights": {
"description": "Nonstop departures seen in recent searches for the next month (any cabin, a sample): each group is one aircraft with every flight number it was sold under.",
"properties": {
"checked": {
"type": "string"
},
"groups": {
"items": {
"type": "object"
},
"type": "array"
}
},
"type": [
"object",
"null"
]
},
"oneWay": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest one-way fare within 6 months."
},
"origin": {
"properties": {
"city": {
"type": "string"
},
"code": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"city",
"code"
],
"type": "object"
},
"page": {
"description": "Route page to cite.",
"type": "string"
},
"premiumEconomyLink": {
"description": "Affiliate link opening an Aviasales Premium Economy (w1) search on the same dates.",
"type": "string"
},
"route": {
"type": "string"
},
"verdict": {
"type": [
"object",
"null"
]
}
},
"required": [
"route",
"origin",
"destination",
"page",
"bookingLink",
"bookingSearch"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"city",
"page",
"routes"
],
"type": "object"
}
},
{
"description": "Business class & First class price check: evaluates whether a fare quoted elsewhere (in EUR, round trip per adult) is a steal, good, fair or overpriced vs our daily route history and distance benchmark, and returns a cheaper Aviasales booking link if we observed a lower price.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cabin": {
"default": "business",
"enum": [
"business",
"first"
],
"type": "string"
},
"from": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
},
"price_eur": {
"description": "Quoted round-trip fare per adult in EUR.",
"maximum": 50000,
"minimum": 100,
"type": "number"
},
"to": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
}
},
"required": [
"from",
"to",
"price_eur"
],
"type": "object"
},
"name": "check_business_or_first_price",
"outputSchema": {
"properties": {
"bookingLink": {
"type": [
"string",
"null"
]
},
"cabin": {
"type": "string"
},
"found": {
"type": "string"
},
"quotedEur": {
"type": "number"
},
"rating": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"found",
"rating",
"summary"
],
"type": "object"
}
},
{
"description": "Business class & First class positioning comparison: checks nearby and same-country departure airports/cities to the same destination to find €500–€2,500+ savings (e.g. flying from Milan, Dublin, Warsaw or Madrid instead of London, Zurich or Frankfurt).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cabin": {
"default": "business",
"enum": [
"business",
"first"
],
"type": "string"
},
"from": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
},
"to": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "compare_departure_hubs",
"outputSchema": {
"properties": {
"alternatives": {
"items": {
"type": "object"
},
"type": "array"
},
"cabin": {
"type": "string"
},
"destination": {
"type": "string"
},
"directRoute": {
"type": [
"object",
"null"
]
},
"originRequested": {
"type": "string"
}
},
"required": [
"originRequested",
"destination",
"alternatives"
],
"type": "object"
}
},
{
"description": "First Class suites & flagship cabins (trip_class=2) round-trip fares on long-haul routes from Aviasales data, ranked cheapest first, with First Class booking links. Optional `from` filters to one departure city.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"from": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
},
"limit": {
"default": 10,
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "first_class_fares",
"outputSchema": {
"properties": {
"fetchedAt": {
"type": "string"
},
"page": {
"type": "string"
},
"routes": {
"items": {
"properties": {
"bookingLink": {
"description": "Affiliate link through flat.flights/go/.",
"type": "string"
},
"bookingSearch": {
"description": "What bookingLink opens: site, dates (null = about two weeks ahead) and adults.",
"properties": {
"adults": {
"type": "integer"
},
"depart": {
"type": [
"string",
"null"
]
},
"partner": {
"type": "string"
},
"return": {
"type": [
"string",
"null"
]
}
},
"required": [
"partner",
"depart",
"adults"
],
"type": "object"
},
"cheapest": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
]
},
"cheapestMonth": {
"type": [
"object",
"null"
]
},
"destination": {
"properties": {
"city": {
"type": "string"
},
"code": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"city",
"code"
],
"type": "object"
},
"distanceKm": {
"type": "number"
},
"fares": {
"items": {
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
"type": "array"
},
"firstClass": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest First Class (trip_class=2) round trip within 6 months."
},
"firstClassLink": {
"description": "Affiliate link opening an Aviasales First Class (f1) search.",
"type": "string"
},
"history": {
"type": [
"object",
"null"
]
},
"later": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest fare departing after the 6-month horizon."
},
"lieFlat": {
"description": "likely or unknown, from the nonstop flights seen and our airline seat data, with the reason.",
"properties": {
"basis": {
"type": "string"
},
"status": {
"enum": [
"likely",
"unknown"
],
"type": "string"
}
},
"type": "object"
},
"months": {
"additionalProperties": {
"type": "number"
},
"description": "Cheapest fare per departure month (YYYY-MM).",
"type": "object"
},
"nonstop": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest nonstop round trip within 6 months."
},
"nonstopFlights": {
"description": "Nonstop departures seen in recent searches for the next month (any cabin, a sample): each group is one aircraft with every flight number it was sold under.",
"properties": {
"checked": {
"type": "string"
},
"groups": {
"items": {
"type": "object"
},
"type": "array"
}
},
"type": [
"object",
"null"
]
},
"oneWay": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest one-way fare within 6 months."
},
"origin": {
"properties": {
"city": {
"type": "string"
},
"code": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"city",
"code"
],
"type": "object"
},
"page": {
"description": "Route page to cite.",
"type": "string"
},
"premiumEconomyLink": {
"description": "Affiliate link opening an Aviasales Premium Economy (w1) search on the same dates.",
"type": "string"
},
"route": {
"type": "string"
},
"verdict": {
"type": [
"object",
"null"
]
}
},
"required": [
"route",
"origin",
"destination",
"page",
"bookingLink",
"bookingSearch"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"page",
"routes"
],
"type": "object"
}
},
{
"description": "Cheapest round-trip business class fare between two cities, with dates, stops, cheapest departure month, cheapest nonstop and one-way fares, nonstop flights seen (airline, flight, airports), a lie-flat assessment and a booking link that opens a search on the quoted fare's dates (or the traveller's dates, if given).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"adults": {
"default": 1,
"description": "Adults for the booking link search.",
"maximum": 9,
"minimum": 1,
"type": "integer"
},
"depart_date": {
"description": "Outbound date (YYYY-MM-DD, today to 330 days ahead). Optional: the booking link then opens the search on the traveller's dates instead of the quoted fare's.",
"format": "date",
"type": [
"string",
"null"
]
},
"from": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
},
"return_date": {
"description": "Return date; omit with depart_date for one way (YYYY-MM-DD, today to 330 days ahead). Optional: the booking link then opens the search on the traveller's dates instead of the quoted fare's.",
"format": "date",
"type": [
"string",
"null"
]
},
"to": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "search_business_class_fares",
"outputSchema": {
"description": "found=archive: route from the daily archive. found=live: pair outside the archive, fares from a direct lookup.",
"properties": {
"bookingLink": {
"type": "string"
},
"bookingSearch": {
"description": "What bookingLink opens: site, dates (null = about two weeks ahead) and adults.",
"properties": {
"adults": {
"type": "integer"
},
"depart": {
"type": [
"string",
"null"
]
},
"partner": {
"type": "string"
},
"return": {
"type": [
"string",
"null"
]
}
},
"required": [
"partner",
"depart",
"adults"
],
"type": "object"
},
"destination": {
"type": "string"
},
"destinationName": {
"type": "string"
},
"fares": {
"items": {
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
"type": "array"
},
"fetchedAt": {
"type": "string"
},
"found": {
"enum": [
"archive",
"live",
"none"
],
"type": "string"
},
"origin": {
"type": "string"
},
"originName": {
"type": "string"
},
"page": {
"type": [
"string",
"null"
]
},
"reason": {
"type": "string"
},
"requested": {
"description": "Present when depart_date was passed: how the fares seen compare with the traveller's dates.",
"properties": {
"adults": {
"type": "integer"
},
"cheapestInMonthEur": {
"type": [
"number",
"null"
]
},
"depart": {
"type": "string"
},
"nearestFare": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
]
},
"quoteMatchesDates": {
"type": "boolean"
},
"return": {
"type": [
"string",
"null"
]
},
"totalEur": {
"type": [
"number",
"null"
]
}
},
"required": [
"depart",
"adults",
"quoteMatchesDates"
],
"type": [
"object",
"null"
]
},
"route": {
"properties": {
"bookingLink": {
"description": "Affiliate link through flat.flights/go/.",
"type": "string"
},
"bookingSearch": {
"description": "What bookingLink opens: site, dates (null = about two weeks ahead) and adults.",
"properties": {
"adults": {
"type": "integer"
},
"depart": {
"type": [
"string",
"null"
]
},
"partner": {
"type": "string"
},
"return": {
"type": [
"string",
"null"
]
}
},
"required": [
"partner",
"depart",
"adults"
],
"type": "object"
},
"cheapest": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
]
},
"cheapestMonth": {
"type": [
"object",
"null"
]
},
"destination": {
"properties": {
"city": {
"type": "string"
},
"code": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"city",
"code"
],
"type": "object"
},
"distanceKm": {
"type": "number"
},
"fares": {
"items": {
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
"type": "array"
},
"firstClass": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest First Class (trip_class=2) round trip within 6 months."
},
"firstClassLink": {
"description": "Affiliate link opening an Aviasales First Class (f1) search.",
"type": "string"
},
"history": {
"type": [
"object",
"null"
]
},
"later": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest fare departing after the 6-month horizon."
},
"lieFlat": {
"description": "likely or unknown, from the nonstop flights seen and our airline seat data, with the reason.",
"properties": {
"basis": {
"type": "string"
},
"status": {
"enum": [
"likely",
"unknown"
],
"type": "string"
}
},
"type": "object"
},
"months": {
"additionalProperties": {
"type": "number"
},
"description": "Cheapest fare per departure month (YYYY-MM).",
"type": "object"
},
"nonstop": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest nonstop round trip within 6 months."
},
"nonstopFlights": {
"description": "Nonstop departures seen in recent searches for the next month (any cabin, a sample): each group is one aircraft with every flight number it was sold under.",
"properties": {
"checked": {
"type": "string"
},
"groups": {
"items": {
"type": "object"
},
"type": "array"
}
},
"type": [
"object",
"null"
]
},
"oneWay": {
"anyOf": [
{
"description": "Business fare seen by Aviasales users, EUR per adult (return null: one way).",
"properties": {
"depart": {
"format": "date",
"type": "string"
},
"priceEur": {
"type": "number"
},
"return": {
"type": [
"string",
"null"
]
},
"seenOn": {
"format": "date",
"type": "string"
},
"stops": {
"type": "integer"
}
},
"required": [
"priceEur",
"depart"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Cheapest one-way fare within 6 months."
},
"origin": {
"properties": {
"city": {
"type": "string"
},
"code": {
"type": "string"
},
"country": {
"type": "string"
}
},
"required": [
"city",
"code"
],
"type": "object"
},
"page": {
"description": "Route page to cite.",
"type": "string"
},
"premiumEconomyLink": {
"description": "Affiliate link opening an Aviasales Premium Economy (w1) search on the same dates.",
"type": "string"
},
"route": {
"type": "string"
},
"verdict": {
"type": [
"object",
"null"
]
}
},
"required": [
"route",
"origin",
"destination",
"page",
"bookingLink",
"bookingSearch"
],
"type": "object"
}
},
"required": [
"found"
],
"type": "object"
}
},
{
"description": "Real-time flight verification (~8 seconds): queries airlines and OTAs live for exact dates to confirm bookable EUR prices right now, operating airlines, flight numbers, widebody vs narrowbody aircraft on each leg, and a `directCheckoutLink` that opens the airline or OTA booking cart directly. Call this when the user is ready to verify or book specific dates.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"adults": {
"default": 1,
"maximum": 9,
"minimum": 1,
"type": "integer"
},
"cabin": {
"default": "business",
"enum": [
"business",
"first",
"premium"
],
"type": "string"
},
"depart_date": {
"description": "Outbound date (YYYY-MM-DD, today to 330 days ahead).",
"format": "date",
"type": "string"
},
"from": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
},
"return_date": {
"description": "Return date; omit for one way (YYYY-MM-DD, today to 330 days ahead). Optional: the booking link then opens the search on the traveller's dates instead of the quoted fare's.",
"format": "date",
"type": [
"string",
"null"
]
},
"to": {
"description": "City name (e.g. \"Milan\", \"New York\") or 3-letter IATA city/airport code (e.g. \"MIL\", \"JFK\").",
"maxLength": 80,
"type": "string"
}
},
"required": [
"from",
"to",
"depart_date"
],
"type": "object"
},
"name": "verify_live_flight_offers",
"outputSchema": {
"properties": {
"adults": {
"type": "integer"
},
"aviasalesSearchLink": {
"type": "string"
},
"cabin": {
"type": "string"
},
"departDate": {
"type": "string"
},
"destination": {
"type": "string"
},
"note": {
"type": "string"
},
"offers": {
"items": {
"type": "object"
},
"type": "array"
},
"offersCount": {
"type": "integer"
},
"origin": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"ok",
"no_offers",
"archive_fallback",
"unavailable"
],
"type": "string"
},
"verifiedAt": {
"type": "string"
}
},
"required": [
"status",
"offers",
"aviasalesSearchLink"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:423f2d419882c0acb6c883094f9d408c2ff3f2b65e52d7a1609bef2da1219d6b | sha256sum