{"uid":"cap_TRbVGVKmvx91VP9c2UDgS","slug":"faa-tfr-corridor-query-x402-a43bd222","name":"FAA TFR Corridor Query (x402)","description":"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).","url":"https://faa-x402.quietworklabs.workers.dev/v1/tfr-corridor?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CWg8__XmzZebuon1ncm9r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns GeoJSON FeatureCollection of active or upcoming FAA Temporary Flight Restrictions (TFRs) within a specified bounding box, optionally filtered by altitude and buffer distance.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pre-flight TFR corridor check","prompt":"Before my VFR flight from Chattanooga to Atlanta tomorrow, can you check for any active or upcoming FAA TFRs along that corridor — roughly the bounding box from -86,34.8 to -84,33.5 — and flag anything below 10,000 feet?"},{"title":"Stadium event airspace restriction","prompt":"There's a big game at SoFi Stadium in Los Angeles this Sunday — can you look up any FAA TFRs in the bounding box around -118.4,33.9 to -118.3,34.0 and tell me if there's a stadium restriction active?"},{"title":"Security TFR monitoring near VIP event","prompt":"The President is traveling near Miami this week — can you pull all FAA TFRs in the bounding box -80.5,25.6 to -80.1,25.9 including upcoming ones, and tell me the altitude bands and effective times for any security TFRs?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:43:56.968Z","isFirstParty":false,"canonicalSlug":"faa-tfr-corridor-query-x402-a43bd222"}