For Agents
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the AviationData.Systems Airports API V1, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with AviationData.Systems Airports API V1 API.
Resolve an airport's full record from a 3-letter IATA code via /v1/airport/iata/{airport_iata}
Autocomplete airport names against a partial string for typeahead search inputs
Find the nearest N airports to a latitude and longitude pair for routing and proximity logic
GET STARTED
Resolve global airports by IATA code, name, or geographic proximity, and look up countries and their airport lists for travel and flight workflows.
Use for: I want to look up the airport details for IATA code DUB, Find the 5 airports nearest to latitude 40.7128, longitude -74.0060, Search for airports whose name starts with 'San Fran', List all airports in Ireland
Not supported: Does not handle live flight tracking, schedules, fares, or aircraft data — use for airport reference lookups by code, name, or coordinates only.
Jentic publishes the only available OpenAPI specification for AviationData.Systems Airports API V1, keeping it validated and agent-ready. The Airports API exposes a global airport reference dataset with lookup by IATA code, fuzzy name autocomplete, nearest-airport search by latitude and longitude, and country-level airport listings. It is intended for travel apps, flight tooling, and any workflow that needs to resolve airport codes, names, and coordinates without maintaining its own dataset.
List airports for a given country code to scope flight searches geographically
Retrieve a normalised country list for populating country selectors in travel UIs
Patterns agents use AviationData.Systems Airports API V1 API for, with concrete tasks.
★ IATA Code Resolution for Travel UIs
Travel platforms call /v1/airport/iata/{airport_iata} to expand a 3-letter IATA code into a full airport record with name, city, country, and coordinates. This powers itinerary displays, booking confirmations, and any UI that receives bare IATA codes from a GDS or aggregator and needs human-readable details.
Given IATA code 'JFK', call GET /v1/airport/iata/JFK and return the airport name, city, country, latitude, and longitude
Nearest-Airport Search for Routing
Logistics, ride-share, and travel concierge apps call /v1/airport/nearest/{result_count}/{latitude}/{longitude} to find the closest airports to a user or shipment location. The endpoint accepts a result count and coordinates and returns the nearest airports in distance order, replacing custom geo-indexing on a private airport dataset.
Given coordinates 51.5074, -0.1278, call GET /v1/airport/nearest/3/51.5074/-0.1278 and return the three closest airports with distance
Airport Name Autocomplete
Booking flows and search bars call /v1/airport/autocomplete/{airport_name} to suggest airports as the user types a partial name. The endpoint returns ranked matches that the UI can render in a dropdown, eliminating the need to ship a multi-megabyte airport list to the browser.
Given the partial string 'Heath', call GET /v1/airport/autocomplete/Heath and return the top 5 matching airports
Agent-Driven Travel Planning via Jentic
Travel-planning agents call the Airports API through Jentic to resolve user-supplied city names or coordinates into the actual airport codes a flight-search API expects. Jentic exposes the six operations as discoverable tools so the agent picks the right one — IATA lookup, autocomplete, or nearest — based on the user's phrasing.
Given a user request 'Find a flight from near Trinity College Dublin to New York', search Jentic for 'find nearest airport', call the nearest-airport endpoint, then return the resolved IATA code
6 endpoints — jentic publishes the only available openapi specification for aviationdata.
METHOD
PATH
DESCRIPTION
/v1/airport/iata/{airport_iata}
Resolve an airport by IATA code
/v1/airport/name/{airport_name}
Look up an airport by name
/v1/airport/autocomplete/{airport_name}
Autocomplete airport names from a partial string
/v1/airport/nearest/{result_count}/{latitude}/{longitude}
Find the nearest airports to coordinates
/v1/country/code/{country_code}
List airports in a country by country code
/v1/country_list
List all countries in the dataset
/v1/airport/iata/{airport_iata}
Resolve an airport by IATA code
/v1/airport/name/{airport_name}
Look up an airport by name
/v1/airport/autocomplete/{airport_name}
Autocomplete airport names from a partial string
/v1/airport/nearest/{result_count}/{latitude}/{longitude}
Find the nearest airports to coordinates
/v1/country/code/{country_code}
List airports in a country by country code
Three things that make agents converge on Jentic-routed access.
Credential isolation
AviationData.Systems Basic Auth credentials are stored encrypted in the Jentic vault. Agents call the API through Jentic with scoped access — username and password never enter the agent's context or transcripts.
Intent-based discovery
Agents search by intent (e.g., 'find the nearest airport to a location') and Jentic returns the matching operation from the six available, with the full path-parameter schema so the agent supplies coordinates correctly.
Time to first call
Direct integration: half a day for Basic Auth and path-parameter wiring across six endpoints. Through Jentic: under 15 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
AviationData.Systems Airports API V1 (apis.guru variant)
Same underlying API, packaged from the apis.guru third-party catalog instead of the Jentic-generated spec.
Choose this Jentic-generated spec when validation and agent-readiness matter; choose the apis.guru variant only if you specifically depend on apis.guru tooling.
Specific to using AviationData.Systems Airports API V1 API through Jentic.
Why is there no official OpenAPI spec for AviationData.Systems Airports API V1?
AviationData.Systems does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call AviationData.Systems Airports API V1 via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the AviationData.Systems Airports API use?
The Airports API uses HTTP Basic authentication. Through Jentic, the username and password live in the Jentic vault and are attached as the Authorization header on each request — agents never see the raw credentials.
Can I find the nearest airport to a location with this API?
Yes. GET /v1/airport/nearest/{result_count}/{latitude}/{longitude} returns the closest airports to the supplied coordinates, ordered by distance. The result_count parameter controls how many airports come back.
What are the rate limits for the AviationData.Systems Airports API?
The provider does not publish a fixed rate limit on the spec. Treat it as a low-volume reference API: cache hot lookups (country lists, common IATA codes) on your side and avoid hammering the autocomplete endpoint on every keystroke without debouncing.
How do I autocomplete airport names through Jentic?
Search Jentic for 'autocomplete airport name', load the schema for GET /v1/airport/autocomplete/{airport_name}, and call it with the user's partial string. Jentic returns the matching operation directly so you skip browsing the docs.
What countries does the airport dataset cover?
GET /v1/country_list returns every country present in the dataset, and GET /v1/country/code/{country_code} returns the airports for a given two-letter country code so you can confirm coverage for any country your application needs.
/v1/country_list
List all countries in the dataset