{"uid":"cap_D1m7RXCOMNoj0HEFWDxjt","slug":"aviationapis-taf-terminal-aerodrome-forecast-ae201c1f","name":"AviationAPIs TAF (Terminal Aerodrome Forecast)","description":"Pay-per-call aviation data APIs for AI agents, settled in USDC via the x402 protocol.","url":"https://aviationapis.com/taf","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"icao":{"type":"string","pattern":"^[A-Za-z]{4}$","description":"4-letter ICAO airport code (e.g. 'KSFO', 'EGLL', 'RJTT')"}}},"responseSchema":{"type":"json","example":{"raw":"TAF EGLL 021700Z 0218/0400 24012KT 9999 BKN025","icao":"EGLL","name":"London Heathrow","periods":[{"to":"2026-06-03T06:00:00.000Z","from":"2026-06-02T18:00:00.000Z","wind":{"gust_kt":null,"speed_kt":12,"direction_deg":240},"change":null,"clouds":[{"cover":"BKN","base_ft":2500}],"weather":null,"visibility_sm":6}],"valid_to":"2026-06-04T00:00:00.000Z","issued_at":"2026-06-02T17:00:00Z","fetched_at":"2026-06-02T18:58:11.000Z","valid_from":"2026-06-02T18:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M0g9JKrpc1s9OdHapqtUp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a parsed Terminal Aerodrome Forecast (TAF) for any airport given its ICAO code, including wind, visibility, cloud cover, and forecast periods.","exampleAgentPrompt":"What's the terminal aerodrome forecast for London Heathrow (EGLL) right now — I need wind speed, direction, visibility, and cloud cover broken down by forecast period.","exampleUseCases":null,"resultDescription":"Returns structured TAF data including the raw TAF string, airport name, ICAO code, issuance time, validity window, and an array of forecast periods each containing wind (speed, direction, gust), visibility in statute miles, cloud layers (cover type and base altitude in feet), and any weather phenomena. Also includes fetch timestamp.","failureModes":["Invalid or non-existent ICAO code returns an error — must be exactly 4 letters","Airport has no TAF issued (e.g. small GA airports) — may return empty or error","Payment failure via x402 if USDC wallet is not funded or x402 header is missing","Network timeout if upstream aviation weather data source is unavailable","Stale TAF if the issuing met office has not updated recently"],"whenToPreferThis":"Use this endpoint when you need structured, parsed TAF data for a specific airport identified by its ICAO code, especially within an AI agent workflow that pays per call via x402/USDC. Prefer this over scraping aviation weather sites or calling NOAA APIs directly when you need clean JSON output with decoded forecast periods ready for downstream logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:48:55.504Z","isFirstParty":false}