ATIS Relay API

Authentication

Create a free ATIS Relay account and issue a key under Account → API key. Include this header on every request:

X-Api-Key: <token>

One key per account. Keys can be revoked from the same page.

Available Endpoints

GET /api/atis

Retrieve the latest D-ATIS for one airport. Requires icao. Available on Free, ATIS Relay Plus, and Commercial.

curl "https://atisrelay.com/api/atis?icao=KSFO" \
  -H "X-Api-Key: $TOKEN"

Response:
{
  "atis": {
    "airportID": "KSFO",
    "atisCode": "B",
    "letter": "B",
    "dataBody": "SFO ATIS INFO B 1656Z. ..."
  },
  "departure": null,
  "arrival": null
}

GET /api/datis/all

Returns every current D-ATIS in one response. ATIS Relay Plus and Commercial only. Free keys receive 403. The server caches this payload for 5 minutes and shares that cache across callers. Each key may call this endpoint once every 5 minutes. A second call inside that window returns 429 with Retry-After. This endpoint does not count against the per-airport per-minute burst used by GET /api/atis and GET /api/atis_relay_airport.

curl "https://atisrelay.com/api/datis/all" \
  -H "X-Api-Key: $TOKEN"

Response:
{
  "cached_at": "2026-10-17T19:00:00Z",
  "cache_ttl_seconds": 300,
  "airports": {
    "KSFO": {
      "atis": { "airportID": "KSFO", "letter": "B", "dataBody": "SFO ATIS INFO B 1656Z. ..." },
      "departure": null,
      "arrival": null
    }
  }
}

GET /api/atis/all

Commercial only. Plus and Free keys receive 403. Returns every current ATIS, AWOS, and D-ATIS transcript plus parsed values (information letter, Zulu time, wind, visibility, and altimeter) in the same shape the per-airport endpoint uses for those fields. Runway geometry stays on GET /api/runways. Audio links are Commercial only and expire after 24 hours. Request a new link after it expires. The server caches the condition data for 5 minutes and shares that cache across callers. Audio links are created when the response is sent. Each key may call this endpoint once every 5 minutes. A second call inside that window returns 429 with Retry-After. This endpoint does not count against the per-airport per-minute burst.

curl "https://atisrelay.com/api/atis/all" \
  -H "X-Api-Key: $TOKEN"

Response:
{
  "cached_at": "2026-10-17T19:00:00Z",
  "cache_ttl_seconds": 300,
  "airports": [
    {
      "icao": "KSFO",
      "name": "San Francisco International Airport",
      "transcript": "Information Bravo...",
      "transcript_letter": "B",
      "transcript_valid_time": 1730225400,
      "call_status": "ready",
      "audio": "https://atisrelay.com/api/audio/TOKEN",
      "source": "phone",
      "datis": { "atis": { "letter": "B" }, "departure": null, "arrival": null },
      "parsed": { "letter": "B", "zulu_time": 1730225400, "wind": "28012KT", "visibility": "10", "altimeter": "3008" }
    }
  ]
}

GET /api/atis_relay_airport

Airport info plus latest conditions. Requires icao. Available on Free, ATIS Relay Plus, and Commercial. Audio links are included for ATIS Relay Plus and Commercial keys. Free keys receive audio as null and a notice that audio requires a paid plan. Audio links expire after 24 hours. Request a new link after it expires. Fetching an audio link counts against the key's per-minute and daily limits. Paid keys may add include=notams to attach the same NOTAMs the airport pages use. Free keys that pass include=notams still receive the normal airport payload plus a notice that NOTAMs require a paid plan.

curl "https://atisrelay.com/api/atis_relay_airport?icao=KSFO&include=notams" \
  -H "X-Api-Key: $TOKEN"

Response:
{
  "transcript": "Information Bravo...",
  "transcript_letter": "B",
  "transcript_valid_time": 1730225400,
  "call_status": "ready",
  "audio": "https://atisrelay.com/api/audio/TOKEN",
  "metar": { "report": "KSFO 121656Z ...", "flight_rules": "VFR" },
  "datis": { "raw": "..." },
  "airport": { "icao": "KSFO", "name": "San Francisco International Airport" },
  "notams": [
    { "text": "!SFO 10/001 RWY 28L CLSD", "type": "N", "effective_dt": "2026-10-01T12:00:00Z", "age": "new" }
  ]
}

GET /api/atis_relay_index

Lists supported airports.

curl https://atisrelay.com/api/atis_relay_index \
  -H "X-Api-Key: $TOKEN"

Response:
{
  "datis": ["KJFK", "KLAX", "KSFO"],
  "transcribed": ["KAPA", "KCRQ", "KSEE"]
}

GET /api/atis_relay_dial

Initiates ATIS capture for non-D-ATIS airports. Requires icao. ATIS Relay Plus and Commercial only (402 on a free key).

curl "https://atisrelay.com/api/atis_relay_dial?icao=KSEE" \
  -H "X-Api-Key: $TOKEN"

Response:
{ "message": "Call in progress" }

GET /api/audio/:token

Fetches the audio for a link returned by GET /api/atis_relay_airport or GET /api/atis/all. ATIS Relay Plus and Commercial only. Audio links expire after 24 hours. Request a new link after it expires. Each fetch counts against the key's per-minute and daily limits. Expired or invalid links return 404.

curl -L "https://atisrelay.com/api/audio/TOKEN" \
  -H "X-Api-Key: $TOKEN"

GET /api/notams

Returns current NOTAMs for one airport. Requires icao. ATIS Relay Plus and Commercial only. Free keys receive 403. Reuses the same FAA NOTAM fetch and 15-minute cache as uncovered airport pages. Counts against the normal per-key minute and daily limits.

curl "https://atisrelay.com/api/notams?icao=KSEE" \
  -H "X-Api-Key: $TOKEN"

Response:
{
  "icao": "KSEE",
  "notams": [
    { "text": "!SEE 10/001 TWY A CLSD", "type": "N", "effective_dt": "2026-10-01T12:00:00Z", "effective_end_dt": "2026-10-15T23:59:00Z", "age": "new" }
  ]
}

GET /api/runways

Returns runway data. Provide icao or faa_loc_id.

curl "https://atisrelay.com/api/runways?icao=KSFO" \
  -H "X-Api-Key: $TOKEN"

Response:
[
  { "rwy_id": "10L/28R", "rwy_len": 11870, "rwy_width": 200, "surface": "ASPH" }
]

GET /api/freqs

Returns frequencies. Provide icao or faa_loc_id.

curl "https://atisrelay.com/api/freqs?icao=KSFO" \
  -H "X-Api-Key: $TOKEN"

Response:
[
  { "name": "TOWER", "frequency": "120.50", "twr_comm_call": "San Francisco Tower" }
]

GET /api/airport_rmks

Returns FAA airport remarks. Provide icao or faa_loc_id.

curl "https://atisrelay.com/api/airport_rmks?icao=KSFO" \
  -H "X-Api-Key: $TOKEN"

Response:
[
  { "element": "SERVICES", "remark": "FUEL 100LL JET A" }
]