curl -H "x-apikey: YOUR_API_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/airports/KBOS"

curl -H "x-apikey: $AEROAPI_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/flights/UAL123-1234567890-airline-0123/position"

# Get recent flights for UAL123
curl -H "x-apikey: $AEROAPI_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/flights/UAL123"

# Get flights for registration N12345
curl -H "x-apikey: $AEROAPI_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/flights/N12345?ident_type=registration"

# Flights in Boston area below 10000ft
curl -H "x-apikey: $AEROAPI_KEY" \
  'https://aeroapi.flightaware.com/aeroapi/flights/search?query=-latlong "41.5 -72.5 43.5 -69.5" -belowAltitude 100'

# AAL flights to/from Boston area airports below 8000ft
curl -H "x-apikey: $AEROAPI_KEY" \
  'https://aeroapi.flightaware.com/aeroapi/flights/search/advanced?query={orig_or_dest {KBOS KBED KOWD}} {<= alt 80} {match ident AAL*}'

curl -H "x-apikey: $AEROAPI_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/airports/KBOS"

# Get Boston weather
curl -H "x-apikey: $AEROAPI_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/airports/KBOS/weather/observations"

# Airports within 25 miles of East Boston
curl -H "x-apikey: $AEROAPI_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/airports/nearby?latitude=42.369&longitude=-71.041&radius=25"

curl -H "x-apikey: $AEROAPI_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/operators/UAL"

{
  "ident": "UAL123",
  "origin": "KBOS",
  "destination": "KLAX",
  "events": {
    "departure": true,
    "arrival": true
  },
  "target_url": "https://my-webhook.example.com/alerts"
}

{
  "url": "https://my-webhook.example.com/aeroapi"
}

# Get UAL123 flights from October 2024
curl -H "x-apikey: $AEROAPI_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/history/flights/UAL123?start=2024-10-01&end=2024-10-07"

curl -H "x-apikey: $AEROAPI_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/aircraft/N12345/owner"

curl -H "x-apikey: $AEROAPI_KEY" \
  "https://aeroapi.flightaware.com/aeroapi/aircraft/types/B738"

{
  "links": { "next": "/aeroapi/...?cursor=..." },
  "num_pages": 1,
  "flights": [...]
}

{
  "ident": "UAL123",
  "ident_icao": "UAL123",
  "ident_iata": "UA123",
  "fa_flight_id": "UAL123-1234567890-airline-0123",
  "registration": "N12345",
  "operator": "UAL",
  "aircraft_type": "B738",
  "origin": {
    "code": "KBOS",
    "code_icao": "KBOS",
    "code_iata": "BOS",
    "timezone": "America/New_York",
    "name": "Boston Logan Intl",
    "city": "Boston"
  },
  "destination": {...},
  "scheduled_out": "2025-01-01T12:00:00Z",
  "estimated_out": "2025-01-01T12:05:00Z",
  "actual_out": "2025-01-01T12:07:00Z",
  "scheduled_off": "2025-01-01T12:15:00Z",
  "estimated_off": "2025-01-01T12:20:00Z",
  "actual_off": "2025-01-01T12:22:00Z",
  "scheduled_on": "2025-01-01T15:30:00Z",
  "estimated_on": "2025-01-01T15:25:00Z",
  "scheduled_in": "2025-01-01T15:40:00Z",
  "estimated_in": "2025-01-01T15:35:00Z",
  "status": "En Route",
  "progress_percent": 45,
  "route": "BOSRP5 DRUNK WITCH ACK J174 MERIT",
  "route_distance": 2586,
  "filed_altitude": 350,
  "filed_airspeed": 450,
  "departure_delay": 420,
  "arrival_delay": -300
}

{
  "fa_flight_id": "UAL123-1234567890-airline-0123",
  "altitude": 350,
  "altitude_change": "C",
  "groundspeed": 485,
  "heading": 270,
  "latitude": 42.3656,
  "longitude": -71.0096,
  "timestamp": "2025-01-01T13:45:00Z",
  "update_type": "A"
}

import os
import requests
from flask import Flask, abort
from flask_caching import Cache

AEROAPI_BASE_URL = "https://aeroapi.flightaware.com/aeroapi"
AEROAPI_KEY = os.environ["AEROAPI_KEY"]

# Create session with auth header
AEROAPI = requests.Session()
AEROAPI.headers.update({"x-apikey": AEROAPI_KEY})

# Make request
result = AEROAPI.get(f"{AEROAPI_BASE_URL}/airports/KBOS")
if result.status_code != 200:
    abort(result.status_code)
data = result.json()

#!/usr/bin/env python3
"""Simple AeroAPI client example."""

import os
import requests
from typing import Optional

AEROAPI_BASE = "https://aeroapi.flightaware.com/aeroapi"

def aeroapi_request(endpoint: str, params: Optional[dict] = None) -> dict:
    """Make authenticated request to AeroAPI."""
    api_key = os.environ.get("AEROAPI_KEY")
    if not api_key:
        raise ValueError("AEROAPI_KEY environment variable not set")

    headers = {"x-apikey": api_key}
    url = f"{AEROAPI_BASE}{endpoint}"

    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()

def get_airport_info(icao: str) -> dict:
    """Get airport information."""
    return aeroapi_request(f"/airports/{icao}")

def get_airport_arrivals(icao: str, airline: Optional[str] = None) -> dict:
    """Get recent arrivals at airport."""
    params = {"airline": airline} if airline else None
    return aeroapi_request(f"/airports/{icao}/flights/arrivals", params)

def get_flight_position(fa_flight_id: str) -> dict:
    """Get current position for flight."""
    return aeroapi_request(f"/flights/{fa_flight_id}/position")

def search_flights(query: str) -> dict:
    """Search for flights."""
    return aeroapi_request("/flights/search", {"query": query})

def get_weather(icao: str) -> dict:
    """Get current weather at airport."""
    return aeroapi_request(f"/airports/{icao}/weather/observations")

if __name__ == "__main__":
    import json
    import sys

    if len(sys.argv) < 2:
        print("Usage: aeroapi-client.py <command> [args]")
        print("Commands: airport, arrivals, weather, search")
        sys.exit(1)

    cmd = sys.argv[1]

    if cmd == "airport" and len(sys.argv) > 2:
        result = get_airport_info(sys.argv[2])
    elif cmd == "arrivals" and len(sys.argv) > 2:
        result = get_airport_arrivals(sys.argv[2])
    elif cmd == "weather" and len(sys.argv) > 2:
        result = get_weather(sys.argv[2])
    elif cmd == "search" and len(sys.argv) > 2:
        result = search_flights(" ".join(sys.argv[2:]))
    else:
        print(f"Unknown command or missing args: {cmd}")
        sys.exit(1)

    print(json.dumps(result, indent=2))