# US Airport Delays (FAA)

> US Airport Delays (FAA) is a paid API for AI agents from data.tollkit.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Returns real-time FAA-managed delay events (ground delays, ground stops, etc.) for a specific US airport or all airports currently experiencing delays.

## Facts

- Endpoint: POST https://data.tollkit.dev/airport/status?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-airport-delays-faa-f0bb5ef7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZW5T9VDUQl3iyt0wywcUf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability us-airport-delays-faa-f0bb5ef7 -d '<json body>'
```

Example prompt: What FAA delays are active at Boston Logan (BOS) right now — give me the delay type, reason, and how long the average wait is.

## When to prefer this

Use this endpoint when you need authoritative, real-time FAA-level delay data for US airports — specifically ground delays, ground stops, and similar airspace management events sourced directly from nasstatus.faa.gov. Prefer this over airline-specific flight status APIs when the question is about systemic FAA-managed delays (affecting many flights) rather than individual flight status. It requires no account or API key — just a pay-per-call USDC micropayment via x402.

## Known failure modes

- Invalid airport code format (not 3-4 alphanumeric characters) — likely a 400 or validation error
- Airport not found or not a US airport — may return empty events array
- FAA feed temporarily unavailable — stale or missing feed_updated timestamp
- No delays active at the specified airport — status field will not indicate delays, events array will be empty
- Payment failure via x402 — request rejected before processing

## How this service works

SEC filings and financials, IP lookup, US weather, airport delays, address geocoding and exchange rates. Other Tollkit tools are described at: https://extract.tollkit.dev/openapi.json, https://attest.tollkit.dev/openapi.json, https://web.tollkit.dev/openapi.json, https://chain.tollkit.dev/openapi.json.

## Output

Returns a JSON object with the airport's current delay status, a list of delay events (each with type such as ground_delay or ground_stop, reason, average/min/max delay durations, trend, and whether airline flights are affected), the FAA data source attribution, and the timestamp when the feed was last updated. If no airport code is supplied, returns events for all airports currently experiencing delays.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "airport": {
   "type": "string",
   "pattern": "^[A-Za-z0-9]{3,4}$",
   "description": "IATA (JFK) or ICAO (KJFK). Leave out for every airport with delays."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Delays the FAA is managing at the airport level right now. Individual flights can be late or cancelled for other reasons; check the airline for a specific flight.",
  "events": [
   {
    "end": null,
    "type": "ground_delay",
    "start": null,
    "trend": null,
    "reason": "low ceilings",
    "airport": "BOS",
    "max_delay": "23 hours and 59 minutes",
    "min_delay": null,
    "average_delay": "2 hours and 10 minutes",
    "affects_airline_flights": true
   }
  ],
  "source": "U.S. Federal Aviation Administration, National Airspace System Status (nasstatus.faa.gov)",
  "status": "delays",
  "airport": "BOS",
  "feed_updated": "Mon Oct 5 00:24:41 2026 GMT"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-airport-delays-faa-f0bb5ef7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.tollkit.dev](https://www.zero.xyz/host/data.tollkit.dev/llms.txt)
