# FAA US Airport Delays API

> FAA US Airport Delays API is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-22).

Returns current FAA-sourced US airport delay information including ground stops, ground delay programs, arrival/departure delays, and closures for one or all US airports

## Facts

- Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/airport-delays?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/faa-us-airport-delays-api-1e972048
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4-seoDeoPH0oNdLJFUpcb

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 faa-us-airport-delays-api-1e972048 -d '<json body>'
```

Example prompt: Are there any current FAA ground stops or departure delays at SFO right now?

## When to prefer this

Use this endpoint when you need real-time FAA-sourced US airport operational status — ground stops, ground delay programs, or arrival/departure delays — for one specific US airport or all US airports at once. Do not use for tracking a specific flight number's status, for airports outside the US, or for historical delay data.

## Known failure modes

- Invalid or non-US airport code returns an error or empty result — endpoint only supports US airports
- No delays present returns a valid response with empty arrays and total=0
- Truncated or stale FAA data if FAA upstream is slow — updatedAt timestamp may be older than expected
- Non-existent airport code (e.g. typo like 'SFX') may return empty or error response
- Payment failure (insufficient USDC) results in 402 response before data is returned

## How this service works

Use when you need airport delays, FAA ground stops or the airport status of a US airport right now, such as departure delays or closures. Do not use for the status of a flight number, airports outside the US or historical delays. Returns JSON with current US airport delays from the FAA: ground stops, ground delay programs with average and maximum delay, arrival and departure delays and closures, for all airports or one for 0.007 USDC per call. Typical response time 1500 ms (p95). Category: Data.

## Output

A JSON object containing the timestamp of last update, the queried airport code (or null for all airports), total number of active delay events, and arrays of ground stops (with airport and reason), ground delay programs (with average and maximum delay in minutes), arrival/departure delays, and closures (with reason, start time, and reopen time). Also includes an FAA attribution string and a suggested next call hint.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [],
     "properties": {
      "airport": {
       "type": "string",
       "pattern": "^[A-Za-z0-9]{3,4}$",
       "description": "US airport code to filter, e.g. SFO or KSFO (all airports with delays when omitted)"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "updatedAt",
      "airport",
      "total",
      "groundStops",
      "groundDelays",
      "arrivalDepartureDelays",
      "closures",
      "attribution"
     ],
     "properties": {
      "next": {
       "type": "object",
       "required": [
        "service",
        "tool",
        "method",
        "url",
        "useWhen",
        "sample"
       ],
       "properties": {
        "url": {
         "type": "string",
         "description": "Paid route of the next call"
        },
        "tool": {
         "type": "string",
         "description": "MCP tool name of the same call"
        },
        "method": {
         "enum": [
          "GET",
          "POST"
         ],
         "type": "string"
        },
        "sample": {
         "type": "string",
         "description": "Free fixed sample of the whole family"
        },
        "service": {
         "type": "string",
         "description": "Service id of the suggested next paid call"
        },
        "useWhen": {
         "type": "string",
         "description": "When the next call is the right one"
        }
       },
       "description": "Suggested next paid call in the same family (call it in a loop when the task continues)",
       "additionalProperties": false
      },
      "total": {
       "type": "number"
      },
      "airport": {
       "type": [
        "string",
        "null"
       ]
      },
      "closures": {
       "type": "array",

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 8,
  "airport": null,
  "closures": [
   {
    "start": "May 27 at 18:26 UTC.",
    "reason": "!LAX 05/277 LAX AD AP CLSD TO NON SKED TRANSIENT GA ACFT EXC 24HR PPR CTC ATLANTIC AVIATION 310-258-9884 OR SIGNATURE AVIATION 310-410-9605 2605271826-2705281600",
    "reopen": "May 28 at 16:00 UTC.",
    "airport": "LAX"
   },
   {
    "start": "Oct 01 at 16:33 UTC.",
    "reason": "!SAN 10/004 SAN AD AP CLSD TO NON SKED TRANSIENT GA ACFT EXC PPR 619-298-7704 2610011633-2701010800",
    "reopen": "Jan 01 at 08:00 UTC.",
    "airport": "SAN"
   }
  ],
  "updatedAt": "Sat Oct 17 16:47:47 2026 GMT",
  "attribution": "Source: FAA National Airspace System Status (nasstatus.faa.gov), U.S. public domain",
  "groundStops": [],
  "groundDelays": [
   {
    "reason": "airport volume",
    "airport": "SAN",
    "average": "53 minutes",
    "maximum": "1 hour and 50 minutes"
   },
   {
    "reason": "other",
    "airport": "YVR",
    "average": "15 minutes",
    "maximum": "43 minutes"
   }
  ],
  "arrivalDepartureDelays": [
   {
    "type": "Departure",
    "trend": "Increasing",
    "reason": "TM Initiatives:MIT:VOL",
    "airport": "MCO",
    "maximum": "30 minutes",
    "minimum": "16 minutes"
   },
   {
    "type": "Departure",
    "trend": "Increasing",
    "reason": "RWY:Construction",
    "airport": "MIA",
    "maximum": "30 minutes",
    "minimum": "16 minutes"
   },
   {
    "type": "Departure",
    "trend": "Increasing",
    "reason": "VOL:Multi-taxi",
    "airport": "PHX",
    "maximum": "30 minutes",
    "minimum": "16 minutes"
   },
   {
    "type": "Departure",
    "trend": "Increasing",
    "reason": "WX:Thunderstorms",
    "airport": "RSW",
    "maximum": "30 minutes",
    "minimum": "16 minutes"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/faa-us-airport-delays-api-1e972048/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway.blackwoodstate8.workers.dev](https://www.zero.xyz/host/x402-gateway.blackwoodstate8.workers.dev/llms.txt)