{"openapi":"3.1.0","info":{"title":"aviationstack (BYOK) API","version":"0.1.0","description":"aviationstack (BYOK) lets an AI assistant read your own aviationstack data through the aviationstack API with a key you supply (aviationstack access key). Read-only: 9 tools (search_flights, get_timetable, list_routes, list_airports, list_airlines, list_airplanes, list_cities, list_countries, list_aircraft_types). The BYOK key travels with each request, is used for that one call only and is never...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-aviationstack.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-aviationstack/docs"},"termsOfService":"https://connectorbay.com/byok-aviationstack/terms"},"servers":[{"url":"https://byok-aviationstack.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-aviationstack/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_flights":{"post":{"operationId":"search_flights","summary":"Search real-time and historical flights by status, date, airports, airline or flight code, with schedule, delays, gates ","description":"Search real-time and historical flights by status, date, airports, airline or flight code, with schedule, delays, gates and live position when available. Use for \"What is the status of flight MU2557\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"flight_iata":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Flight IATA code, for example MU2557.","title":"Flight Iata"},"flight_status":{"anyOf":[{"enum":["scheduled","active","landed","cancelled","incident","diverted"],"type":"string"},{"type":"null"}],"default":null,"description":"Status: scheduled, active, landed, cancelled, incident or diverted.","title":"Flight Status"},"flight_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Flight date YYYY-MM-DD.","title":"Flight Date"},"dep_iata":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Departure airport or city IATA code, for example JFK.","title":"Dep Iata"},"arr_iata":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Arrival airport or city IATA code, for example LAX.","title":"Arr Iata"},"airline_iata":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Airline IATA code, for example AA.","title":"Airline Iata"},"flight_number":{"anyOf":[{"maxLength":6,"type":"string"},{"type":"null"}],"default":null,"description":"Flight number without the airline code, for example 2557.","title":"Flight Number"},"min_delay_arr":{"anyOf":[{"maximum":2000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only flights delayed on arrival by at least this many minutes.","title":"Min Delay Arr"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"title":"search_flightsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_timetable":{"post":{"operationId":"get_timetable","summary":"Get the departure or arrival schedule of one airport with flight codes, airlines, scheduled, estimated and actual times,","description":"Get the departure or arrival schedule of one airport with flight codes, airlines, scheduled, estimated and actual times, terminals and gates. Use for \"What flights are scheduled to depart from JFK\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"iata_code":{"description":"Airport IATA code, for example JFK.","maxLength":3,"title":"Iata Code","type":"string"},"type":{"description":"departure or arrival.","enum":["departure","arrival"],"title":"Type","type":"string"},"status":{"anyOf":[{"enum":["landed","scheduled","cancelled","active","incident","diverted","redirected","unknown"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional flight status: landed, scheduled, cancelled, active, incident, diverted, redirected or unknown.","title":"Status"},"airline_iata":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Only this airline IATA code.","title":"Airline Iata"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"required":["iata_code","type"],"title":"get_timetableArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_routes":{"post":{"operationId":"list_routes","summary":"List airline routes with departure and arrival airports and the airline, optionally filtered by airports, airline or fli","description":"List airline routes with departure and arrival airports and the airline, optionally filtered by airports, airline or flight number. Use for \"Which airlines fly from JFK to LHR\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dep_iata":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Departure airport IATA code.","title":"Dep Iata"},"arr_iata":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Arrival airport IATA code.","title":"Arr Iata"},"airline_iata":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Airline IATA code.","title":"Airline Iata"},"flight_number":{"anyOf":[{"maxLength":6,"type":"string"},{"type":"null"}],"default":null,"description":"Flight number.","title":"Flight Number"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"title":"list_routesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_airports":{"post":{"operationId":"list_airports","summary":"Search airports by name or code and return IATA and ICAO codes, location, time zone and country. Use for \"What is the IA","description":"Search airports by name or code and return IATA and ICAO codes, location, time zone and country. Use for \"What is the IATA code of Heathrow airport\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Search term to match airport names and codes (autocomplete style).","title":"Search"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"title":"list_airportsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_airlines":{"post":{"operationId":"list_airlines","summary":"Search airlines by name or code and return IATA and ICAO codes, call sign, fleet size, status and country. Use for \"What","description":"Search airlines by name or code and return IATA and ICAO codes, call sign, fleet size, status and country. Use for \"What is the IATA code of Lufthansa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Search term to match airline names and codes (autocomplete style).","title":"Search"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"title":"list_airlinesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_airplanes":{"post":{"operationId":"list_airplanes","summary":"Search individual aircraft by registration number or model and return model, series, delivery and registration dates and","description":"Search individual aircraft by registration number or model and return model, series, delivery and registration dates and owner airline code. Use for \"What do we know about the aircraft with registration N12345\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Search term to match registration numbers or models (autocomplete style).","title":"Search"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"title":"list_airplanesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_cities":{"post":{"operationId":"list_cities","summary":"Search cities by name and return city IATA code, country, coordinates and time zone. Use for \"What is the IATA code of t","description":"Search cities by name and return city IATA code, country, coordinates and time zone. Use for \"What is the IATA code of the city of London\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Search term to match city names (autocomplete style).","title":"Search"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"title":"list_citiesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_countries":{"post":{"operationId":"list_countries","summary":"Search countries by name and return ISO codes, capital, continent, currency, population and phone prefix. Use for \"What ","description":"Search countries by name and return ISO codes, capital, continent, currency, population and phone prefix. Use for \"What is the capital and currency of Brazil\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Search term to match country names (autocomplete style).","title":"Search"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"title":"list_countriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_aircraft_types":{"post":{"operationId":"list_aircraft_types","summary":"Search aircraft types by name and return their IATA codes. Use for \"What is the IATA code of the Airbus A320\".","description":"Search aircraft types by name and return their IATA codes. Use for \"What is the IATA code of the Airbus A320\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Search term to match aircraft type names (autocomplete style).","title":"Search"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 100).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Offset"}},"title":"list_aircraft_typesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}