{"openapi":"3.1.0","info":{"title":"IATA Code Lookup API","version":"0.1.0","description":"A fully local IATA/ICAO airport and airline code reference: 160 major world airports and 81 major airlines, each resolvable by IATA or ICAO code, with keyword search, country/region browsing, code-shape classification and a coding-systems glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://iatacode.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/iatacode/docs"},"termsOfService":"https://connectorbay.com/iatacode/terms"},"servers":[{"url":"https://iatacode.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/iatacode/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/airport_lookup":{"post":{"operationId":"airport_lookup","summary":"Resolves one airport by its IATA or ICAO code to its full name, city, country and world region. Use for","description":"Resolves one airport by its IATA or ICAO code to its full name, city, country and world region. Use for\n    \"what airport is JFK\", \"what city is EDDF in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"A 3-letter IATA airport code or 4-letter ICAO airport code.","examples":["JFK","KJFK","LHR"],"maxLength":4,"minLength":2,"title":"Code","type":"string"}},"required":["code"],"title":"airport_lookupArguments","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/airline_lookup":{"post":{"operationId":"airline_lookup","summary":"Resolves one airline by its IATA or ICAO code to its name, country and ATC radio callsign. Use for \"what's","description":"Resolves one airline by its IATA or ICAO code to its name, country and ATC radio callsign. Use for \"what's\n    Delta's ICAO code\", \"who is airline AZ\", \"what airline uses callsign SPEEDBIRD\" (search_airlines handles the\n    callsign case).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"A 2-character IATA airline code or 3-letter ICAO airline code.","examples":["DL","DAL","BA"],"maxLength":3,"minLength":2,"title":"Code","type":"string"}},"required":["code"],"title":"airline_lookupArguments","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/search_airports":{"post":{"operationId":"search_airports","summary":"Keyword search across airport name, city, country, IATA and ICAO code. Use for \"find the airport in","description":"Keyword search across airport name, city, country, IATA and ICAO code. Use for \"find the airport in\n    Nice\", \"airports named after JFK\", \"what's the code for Bengaluru's airport\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword: city, airport name, country, or a code.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"search_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/search_airlines":{"post":{"operationId":"search_airlines","summary":"Keyword search across airline name, country, callsign, IATA and ICAO code. Use for \"airlines based in","description":"Keyword search across airline name, country, callsign, IATA and ICAO code. Use for \"airlines based in\n    India\", \"which airline's callsign is SWISS\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword: airline name, country, callsign, or a code.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"search_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/airports_by_country":{"post":{"operationId":"airports_by_country","summary":"Every airport in this reference for one country. Use for \"list major airports in Japan\".","description":"Every airport in this reference for one country. Use for \"list major airports in Japan\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country name.","examples":["Japan","United States","Brazil"],"minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"airports_by_countryArguments","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/airlines_by_country":{"post":{"operationId":"airlines_by_country","summary":"Every airline in this reference for one country. Use for \"what airlines are based in the UAE\".","description":"Every airline in this reference for one country. Use for \"what airlines are based in the UAE\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"description":"A country name.","minLength":1,"title":"Country","type":"string"}},"required":["country"],"title":"airlines_by_countryArguments","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/airports_by_region":{"post":{"operationId":"airports_by_region","summary":"Every airport in this reference for one of seven world regions -- use region_list to see them all. Use for","description":"Every airport in this reference for one of seven world regions -- use region_list to see them all. Use for\n    \"list Middle East airports\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A world region.","examples":["Europe","Asia","Middle East"],"title":"Region","type":"string"}},"required":["region"],"title":"airports_by_regionArguments","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/region_list":{"post":{"operationId":"region_list","summary":"All world regions covered, with how many airports are in each. Use for \"what regions do you cover\".","description":"All world regions covered, with how many airports are in each. Use for \"what regions do you cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"region_listArguments","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/classify_code":{"post":{"operationId":"classify_code","summary":"Classifies a bare code by shape (2-character alphanumeric, 3-letter, 4-letter) and which coding system(s)","description":"Classifies a bare code by shape (2-character alphanumeric, 3-letter, 4-letter) and which coding system(s)\n    it plausibly belongs to, and resolves it against the dataset if it's a known airport or airline code. Use for\n    \"is LHR an IATA or ICAO code\", \"what kind of code is 6E\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"code":{"description":"A bare code string to classify.","examples":["JFK","KJFK","6E","DAL"],"maxLength":10,"minLength":1,"title":"Code","type":"string"}},"required":["code"],"title":"classify_codeArguments","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/code_glossary":{"post":{"operationId":"code_glossary","summary":"Definitions of airport/airline coding terms -- IATA code, ICAO code, callsign, LID, prefix patterns. Use for","description":"Definitions of airport/airline coding terms -- IATA code, ICAO code, callsign, LID, prefix patterns. Use for\n    \"what's the difference between an IATA and ICAO code\", \"what's a callsign\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"code_glossaryArguments","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}}}}