Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: AviationHS charter quote Airports API
version: 1.0.0
description: Price a private jet charter from published aircraft performance and airport geometry. Read-only endpoints need no key. Indicative broker estimate. AviationHS is an air charter broker under 14 CFR Part 295, not a direct air carrier. Not an offer of air transportation until an operating carrier confirms in writing.
contact:
url: https://aviationhs.org/developers/
license:
name: 'Data: OurAirports (public domain) and manufacturer specifications'
servers:
- url: https://api.aviationhs.org
tags:
- name: Airports
paths:
/v1/airports:
get:
operationId: search_airports
summary: Find a US airport by name, city, ICAO or IATA code — or every field within…
description: Find a US airport by name, city, ICAO or IATA code — or every field within reach of one, filtered by usable runway length. Covers the fields a business jet can actually use (847 in the reference set). Indicative broker estimate. AviationHS is an air charter broker under 14 CFR Part 295, not a direct air carrier. Not an offer of air transportation until an operating carrier confirms in writing.
parameters:
- name: query
in: query
required: false
description: Name, city, ICAO or IATA code.
schema:
type: string
- name: near_icao
in: query
required: false
description: Return fields near this one instead, nearest first.
schema:
type: string
- name: within_nm
in: query
required: false
description: Radius for near_icao. Default 150.
schema:
type: number
- name: min_runway_ft
in: query
required: false
description: Only fields with at least this much hard-surface runway.
schema:
type: number
- name: state
in: query
required: false
description: Two-letter US state code.
schema:
type: string
- name: limit
in: query
required: false
description: Maximum results. Default 20, max 100.
schema:
type: number
responses:
'200':
description: Result
content:
application/json:
schema:
type: object
'400':
description: The input could not be resolved
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Airports
components:
schemas:
Error:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true