Aviationstack Integration

Official API documentation · Pricing and plan features · FAQ

Use KeyPool to request current Aviationstack flight records and aviation reference lists with your team token. The Aviationstack accounts available here are on the Free plan. The endpoints and examples below reflect that plan.

Endpoint and authentication

{YOUR_KEYPOOL_BASE_URL}/v1/aviationstack

Send your KeyPool team token as a bearer token. Do not pass an upstream access_key query parameter.

Authorization: Bearer {KEYPOOL_TOKEN}

Quick start

Current flights

curl -G "${KEYPOOL_BASE_URL}/v1/aviationstack/v1/flights" \
  -H "Authorization: Bearer ${KEYPOOL_TOKEN}" \
  --data-urlencode "dep_iata=SFO" \
  --data-urlencode "limit=10"

Use flight, airport, airline, or status filters to narrow current records. Do not use flight_date to request historical records on the Free plan. A flight record can include IATA and ICAO codes, timezones, and scheduled, estimated, and actual times. Preserve those labels when displaying or comparing times; fields may be absent or null. Status updates may lag events, so the response does not guarantee a current position or event time.

List airports

curl -G "${KEYPOOL_BASE_URL}/v1/aviationstack/v1/airports" \
  -H "Authorization: Bearer ${KEYPOOL_TOKEN}" \
  --data-urlencode "limit=10" \
  --data-urlencode "offset=0"

Reference lists support limit (up to 100 on Free) and zero-based offset. The search parameter is a paid autocomplete feature and is unavailable with these Free accounts.

Free-plan endpoints

Endpoint	Data
/v1/flights	Current flight records and status
/v1/airports	Airport records
/v1/airlines	Airline records
/v1/airplanes	Airplane records
/v1/aircraft_types	Aircraft type records
/v1/cities	City records
/v1/countries	Country records
/v1/taxes	Aviation tax records

The official endpoint availability table lists these seven reference catalogs on all plans. Routes, historical flights, airport timetables, and future flight schedules require a paid plan. The Free plan also excludes reference-list autocomplete.

Plan limits

The current pricing page lists 100 included requests per month per upstream account, non-commercial use, and HTTPS for Free. Each request, including each paginated page, uses the upstream account's allowance. KeyPool does not guarantee a larger combined quota or that an account has requests remaining. Check the Aviationstack FAQ for the provider's status-data and quota explanations.

Interactive API Reference

For the admitted Free operations, see API Reference -> Aviationstack.