Get started with the API

Quick start

  1. Create a free ATIS Relay account and issue a key under Account, API key.
  2. Send that key on every request:
X-Api-Key: YOUR_API_KEY

One key per account. Keys can be revoked from the same page. Replace YOUR_API_KEY with your key. Do not put a real key in shared files.

What you can build

Each example has a request, a live preview, the JSON, and common errors. Previews do not use an API key and do not count against plan limits. Request and response examples use KSFO. Live previews follow the airport you pick.

D-ATIS

GET /api/atis

Latest D-ATIS for one airport. Free, ATIS Relay Plus, and Commercial.

curl "https://atisrelay.com/api/atis?icao=KSFO" \
  -H "X-Api-Key: YOUR_API_KEY"
require "net/http"
require "json"
require "uri"

uri = URI("https://atisrelay.com/api/atis?icao=KSFO")
request = Net::HTTP::Get.new(uri)
request["X-Api-Key"] = "YOUR_API_KEY"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)
const response = await fetch("https://atisrelay.com/api/atis?icao=KSFO", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "https://atisrelay.com/api/atis",
    params={"icao": "KSFO"},
    headers={"X-Api-Key": "YOUR_API_KEY"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Live data loads when this section is on screen.

{
  "atis": {
    "airportID": "KSFO",
    "atisCode": "B",
    "letter": "B",
    "dataBody": "SFO ATIS INFO B 1656Z. WIND 110 AT 7. VISIBILITY 10. SKY BROKEN 4800. TEMPERATURE 15, DEWPOINT 7. ALTIMETER 3009. ADVS YOU HAVE INFO B."
  },
  "departure": null,
  "arrival": null
}

401 Unauthorized

{
  "error": "Unauthorized"
}

Send X-Api-Key with your key from Account, API key.

429 Too Many Requests

{
  "error": "Rate limit exceeded",
  "tier": "free",
  "limit": 500,
  "reset_at": "2026-11-18T00:00:00Z"
}

Wait for the Retry-After header, then retry.

METAR

GET /api/metar

Latest METAR for one airport. Free, ATIS Relay Plus, and Commercial.

curl "https://atisrelay.com/api/metar?icao=KSFO" \
  -H "X-Api-Key: YOUR_API_KEY"
require "net/http"
require "json"
require "uri"

uri = URI("https://atisrelay.com/api/metar?icao=KSFO")
request = Net::HTTP::Get.new(uri)
request["X-Api-Key"] = "YOUR_API_KEY"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)
const response = await fetch("https://atisrelay.com/api/metar?icao=KSFO", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "https://atisrelay.com/api/metar",
    params={"icao": "KSFO"},
    headers={"X-Api-Key": "YOUR_API_KEY"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Live data loads when this section is on screen.

{
  "icao": "KSFO",
  "raw_text": "METAR KSFO 161856Z 11007KT 10SM SCT036 BKN070 14/11 A3010",
  "metars": [
    {
      "icao_id": "KSFO",
      "temp": 14.4,
      "wspd": 7,
      "flt_cat": "VFR"
    }
  ]
}

401 Unauthorized

{
  "error": "Unauthorized"
}

Send X-Api-Key with your key from Account, API key.

429 Too Many Requests

{
  "error": "Rate limit exceeded",
  "tier": "free",
  "limit": 500,
  "reset_at": "2026-11-18T00:00:00Z"
}

Wait for the Retry-After header, then retry.

400 Bad Request

{
  "error": "icao is required"
}

Pass icao on the query string, for example KSFO.

TAF

GET /api/taf

Latest TAF for one airport. Free, ATIS Relay Plus, and Commercial.

curl "https://atisrelay.com/api/taf?icao=KSFO" \
  -H "X-Api-Key: YOUR_API_KEY"
require "net/http"
require "json"
require "uri"

uri = URI("https://atisrelay.com/api/taf?icao=KSFO")
request = Net::HTTP::Get.new(uri)
request["X-Api-Key"] = "YOUR_API_KEY"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)
const response = await fetch("https://atisrelay.com/api/taf?icao=KSFO", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "https://atisrelay.com/api/taf",
    params={"icao": "KSFO"},
    headers={"X-Api-Key": "YOUR_API_KEY"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Live data loads when this section is on screen.

{
  "icao": "KSFO",
  "tafs": [
    {
      "icao_id": "KSFO",
      "raw": "KSFO 121720Z 1218/1324 28012KT P6SM FEW015"
    }
  ]
}

401 Unauthorized

{
  "error": "Unauthorized"
}

Send X-Api-Key with your key from Account, API key.

429 Too Many Requests

{
  "error": "Rate limit exceeded",
  "tier": "free",
  "limit": 500,
  "reset_at": "2026-11-18T00:00:00Z"
}

Wait for the Retry-After header, then retry.

400 Bad Request

{
  "error": "icao is required"
}

Pass icao on the query string, for example KSFO.

Airport

GET /api/airport

Identifiers, location, and elevation for one airport. Free, ATIS Relay Plus, and Commercial.

curl "https://atisrelay.com/api/airport?icao=KSFO" \
  -H "X-Api-Key: YOUR_API_KEY"
require "net/http"
require "json"
require "uri"

uri = URI("https://atisrelay.com/api/airport?icao=KSFO")
request = Net::HTTP::Get.new(uri)
request["X-Api-Key"] = "YOUR_API_KEY"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)
const response = await fetch("https://atisrelay.com/api/airport?icao=KSFO", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "https://atisrelay.com/api/airport",
    params={"icao": "KSFO"},
    headers={"X-Api-Key": "YOUR_API_KEY"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Live data loads when this section is on screen.

{
  "icao": "KSFO",
  "iata": "SFO",
  "name": "San Francisco International Airport",
  "city": "San Francisco",
  "state_code": "CA"
}

401 Unauthorized

{
  "error": "Unauthorized"
}

Send X-Api-Key with your key from Account, API key.

429 Too Many Requests

{
  "error": "Rate limit exceeded",
  "tier": "free",
  "limit": 500,
  "reset_at": "2026-11-18T00:00:00Z"
}

Wait for the Retry-After header, then retry.

404 Not Found

{
  "error": "Not found"
}

Use a published ICAO such as KSFO.

SIGMET and AIRMET

GET /api/advisories

Active SIGMET, AIRMET, G-AIRMET, and CWA records near a point. Free, ATIS Relay Plus, and Commercial.

curl "https://atisrelay.com/api/advisories?lat=37.619&lon=-122.375" \
  -H "X-Api-Key: YOUR_API_KEY"
require "net/http"
require "json"
require "uri"

uri = URI("https://atisrelay.com/api/advisories?lat=37.619&lon=-122.375")
request = Net::HTTP::Get.new(uri)
request["X-Api-Key"] = "YOUR_API_KEY"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)
const response = await fetch("https://atisrelay.com/api/advisories?lat=37.619&lon=-122.375", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "https://atisrelay.com/api/advisories",
    params={"lat": "37.619", "lon": "-122.375"},
    headers={"X-Api-Key": "YOUR_API_KEY"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Live data loads when this section is on screen.

{
  "lat": 37.619,
  "lon": -122.375,
  "advisories": [
    {
      "kind": "sigmet",
      "hazard": "CONVECTIVE"
    }
  ]
}

401 Unauthorized

{
  "error": "Unauthorized"
}

Send X-Api-Key with your key from Account, API key.

429 Too Many Requests

{
  "error": "Rate limit exceeded",
  "tier": "free",
  "limit": 500,
  "reset_at": "2026-11-18T00:00:00Z"
}

Wait for the Retry-After header, then retry.

400 Bad Request

{
  "error": "lat and lon are invalid"
}

Pass a valid lat and lon pair, or omit them for a nationwide list.

NAS status

GET /api/nas/status

Current National Airspace System summary. Free, ATIS Relay Plus, and Commercial.

curl "https://atisrelay.com/api/nas/status" \
  -H "X-Api-Key: YOUR_API_KEY"
require "net/http"
require "json"
require "uri"

uri = URI("https://atisrelay.com/api/nas/status")
request = Net::HTTP::Get.new(uri)
request["X-Api-Key"] = "YOUR_API_KEY"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)
const response = await fetch("https://atisrelay.com/api/nas/status", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "https://atisrelay.com/api/nas/status",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Live data loads when this section is on screen.

{
  "summary": {
    "text": "No nationwide ground stops."
  },
  "counts": {
    "anomalies": 0,
    "tfrs": 0,
    "ground_stops": 0,
    "ground_delay_programs": 0
  }
}

401 Unauthorized

{
  "error": "Unauthorized"
}

Send X-Api-Key with your key from Account, API key.

429 Too Many Requests

{
  "error": "Rate limit exceeded",
  "tier": "free",
  "limit": 500,
  "reset_at": "2026-11-18T00:00:00Z"
}

Wait for the Retry-After header, then retry.

Traffic and flights

GET /api/traffic/flights

Live flights near an airport. Any valid API key. Included traffic requests vary by plan.

curl "https://atisrelay.com/api/traffic/flights?airport=KSFO" \
  -H "X-Api-Key: YOUR_API_KEY"
require "net/http"
require "json"
require "uri"

uri = URI("https://atisrelay.com/api/traffic/flights?airport=KSFO")
request = Net::HTTP::Get.new(uri)
request["X-Api-Key"] = "YOUR_API_KEY"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)
const response = await fetch("https://atisrelay.com/api/traffic/flights?airport=KSFO", {
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "https://atisrelay.com/api/traffic/flights",
    params={"airport": "KSFO"},
    headers={"X-Api-Key": "YOUR_API_KEY"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Live data loads when this section is on screen.

{
  "airport": "KSFO",
  "flights": [
    {
      "ident": "UAL28",
      "altitude": 13400,
      "ground_speed": 280
    }
  ]
}

401 Unauthorized

{
  "error": "Unauthorized"
}

Send X-Api-Key with your key from Account, API key.

429 Too Many Requests

{
  "error": "Rate limit exceeded",
  "tier": "free",
  "limit": 500,
  "reset_at": "2026-11-18T00:00:00Z"
}

Wait for the Retry-After header, then retry.

404 Not Found

{
  "error": "Airport not found"
}

Use a published ICAO such as KSFO.

MCP for AI assistants

MCP server

https://atisrelay.com/mcp

A read-only remote MCP server using Streamable HTTP. It exposes 30 read-only tools that map to GET endpoints. Discovery methods initialize, notifications/initialized, tools/list, and ping work without a key. You can try the MCP server without a key: up to 100 tool calls a day. Get a free API key at https://atisrelay.com/developers for 1,000 requests a month and higher limits. Tool calls beyond that need your ATIS Relay API key as X-Api-Key or Authorization: Bearer. The MCP server never starts a phone-line dial and never creates subscriptions or webhooks.

curl "https://atisrelay.com/mcp" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
require "net/http"
require "json"
require "uri"

uri = URI("https://atisrelay.com/mcp")
request = Net::HTTP::Post.new(uri)
request["Accept"] = "application/json, text/event-stream"
request["Content-Type"] = "application/json"
request["X-Api-Key"] = "YOUR_API_KEY"
request.body = "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body
const response = await fetch("https://atisrelay.com/mcp", {
  method: "POST",
  headers: {
    "Accept": "application/json, text/event-stream",
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_API_KEY"
  },
  body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/list", params: {} })
});
console.log(await response.text());
import requests

response = requests.post(
    "https://atisrelay.com/mcp",
    headers={
        "Accept": "application/json, text/event-stream",
        "Content-Type": "application/json",
        "X-Api-Key": "YOUR_API_KEY",
    },
    json={"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}},
    timeout=30,
)
response.raise_for_status()
print(response.text)
Client config
{
  "mcpServers": {
    "atis-relay": {
      "url": "https://atisrelay.com/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}
Transport Streamable HTTP
Tools 30 read-only
Discovery Works without a key
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      { "name": "get_datis" },
      { "name": "get_metar" },
      { "name": "get_airport" }
    ]
  }
}

401 Unauthorized

{
  "error": "Unauthorized"
}

Send X-Api-Key or Authorization: Bearer with your key.

Plans and limits

Personal API keys are limited by plan. These caps apply to the key.

Plan Per minute Per day Phone-line dials
Free 10 500 Cannot start a new phone-line dial
ATIS Relay Plus 30 1000 100 new dials per UTC month
Commercial 60 No daily included allowance No monthly dial cap

ATIS Relay Plus is $5.99/month. Commercial is usage-based. See API and Commercial plans and the rate card.

Next steps