# FAA TFR Corridor Query (x402) > FAA TFR Corridor Query (x402) is a paid API for AI agents from faa-x402.quietworklabs.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30). Returns GeoJSON FeatureCollection of active or upcoming FAA Temporary Flight Restrictions (TFRs) within a specified bounding box, optionally filtered by altitude and buffer distance. ## Facts - Endpoint: GET https://faa-x402.quietworklabs.workers.dev/v1/tfr-corridor?utm_source=zero.xyz - Price: $0.005/call - Payment: x402 - Status: unknown - Last checked: 2026-10-30 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/faa-tfr-corridor-query-x402-a43bd222 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TRbVGVKmvx91VP9c2UDgS 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-tfr-corridor-query-x402-a43bd222 ``` Example prompt: Are there any FAA temporary flight restrictions active or upcoming over the Atlanta area — roughly between -85 to -84 longitude and 33.4 to 34.1 latitude — below 5000 feet? ## When to prefer this Use this endpoint when you need structured, machine-readable GeoJSON TFR data for a specific geographic corridor in the US, especially for pre-flight planning checks, airspace monitoring agents, or real-time restriction alerts. It is superior to scraping tfr.faa.gov directly because it parses FAA XML into clean JSON with severity metadata, altitude references, and geospatial polygons ready for downstream processing. Choose it over generic FAA airport-status endpoints when the specific need is spatial airspace restriction queries rather than airport ground delay programs. ## Known failure modes - Missing required bbox parameter returns a 400 error - Malformed bbox (wrong number of values or non-numeric) causes a 400 validation error - bbox covers non-US territory may return an empty FeatureCollection - Payment not provided or insufficient triggers a 402 Payment Required response per x402 protocol - Very large bounding boxes may return truncated results (truncated: true in response) - FAA upstream data unavailability may cause stale or empty results ## How this service works Pay-per-call x402 API for live FAA US airport status (ground stops, ground delay programs, arrival/departure delays, closures) parsed into JSON with severity and delay minutes. By Quietwork Labs (see /about, /terms). ## Output A GeoJSON FeatureCollection where each Feature is a TFR polygon with properties including NOTAM ID, TFR type (e.g. SECURITY, EVENT), status (active or upcoming), effective and valid_until UTC timestamps, lower and upper altitude bounds in feet with AGL/MSL reference, FAA facility, US state, area name, a plain-English description, and a detail URL linking to the official FAA XML. Also includes query echo, fetch timestamp, source attribution, and a truncated flag. ## 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" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET" ], "type": "string" }, "queryParams": { "type": "object", "required": [ "bbox" ], "properties": { "bbox": { "type": "string", "description": "Query box minLon,minLat,maxLon,maxLat in WGS84 decimal degrees" }, "alt_ft": { "type": "string", "description": "Optional: only TFRs whose altitude band includes this height in feet" }, "buffer_nm": { "type": "string", "description": "Optional: expand the query box by this many nautical miles. Default 0." }, "active_only": { "type": "string", "description": "Optional: true to drop not-yet-effective (upcoming) TFRs. Default false." } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object" } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "type": "FeatureCollection", "count": 1, "notes": "Altitudes in feet; alt_ref_* is the FAA reference (AGL/MSL/SFC/FL). Times are UTC; valid_until = TFR expire.", "query": { "bbox": [ -85, 33.4, -84, 34.1 ], "alt_ft": null, "buffer_nm": 2, "active_only": false }, "source": "FAA TFR (tfr.faa.gov), US government public data, fused by Quietwork Labs. Not for operational flight planning.", "features": [ { "bbox": [ -84.4, 33.77, -84.36, 33.8 ], "type": "Feature", "geometry": { "type": "Polygon", "coordinates": [ [ [ -84.383, 33.8 ], [ -84.379, 33.799 ], [ -84.376, 33.799 ], [ -84.383, 33.8 ] ] ] }, "properties": { "state": "GA", "status": "upcoming", "facility": "ZTL", "lower_ft": 0, "notam_id": "6/2101", "tfr_type": "SECURITY", "upper_ft": 400, "area_name": "A1", "effective": "2026-10-30T11:00:00", "detail_url": "https://tfr.faa.gov/download/detail_6_2101.xml", "description": "ATLANTA, GA, Friday, October 30, 2026 through Saturday, October 31, 2026 Local", "valid_until": "2026-10-30T22:00:00", "alt_ref_lower": "AGL", "alt_ref_upper": "AGL" } } ], "fetchedAt": "2026-10-24T23:30:00.000Z", "truncated": false, "candidates_scanned": 20 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/faa-tfr-corridor-query-x402-a43bd222/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from faa-x402.quietworklabs.workers.dev](https://www.zero.xyz/host/faa-x402.quietworklabs.workers.dev/llms.txt)