{"uid":"cap_GnocuLw_y6KLgghY7P4sn","slug":"aviationapis-taf-decoder-cd897dc6","name":"AviationAPIs TAF Decoder","description":"Pay-per-call aviation data APIs for AI agents, settled in USDC via the x402 protocol.","url":"https://aviationapis.com/decode-taf","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"raw":{"type":"string","description":"A raw TAF string, e.g. 'TAF KSFO 021720Z 0218/0324 28012KT P6SM FEW020 ...'"}}},"responseSchema":{"type":"json","example":{"raw":"TAF KSFO 021720Z 0218/0324 28012KT P6SM FEW020 FM030400 30008KT P6SM SCT015","issued":"021720Z","amended":false,"periods":[{"to":"0324","from":"0218","type":"INITIAL","wind":{"gust_kt":null,"speed_kt":12,"direction_deg":280},"cavok":false,"clouds":[{"type":null,"cover":"FEW","base_ft":2000}],"weather":null,"probability":null,"visibility_sm":6},{"to":null,"from":"030400","type":"FM","wind":{"gust_kt":null,"speed_kt":8,"direction_deg":300},"cavok":false,"clouds":[{"type":null,"cover":"SCT","base_ft":1500}],"weather":null,"probability":null,"visibility_sm":6}],"station":"KSFO","valid_to":"0324","valid_from":"0218"}},"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_Dc3E1cKpmQ6LZDi-_Ju1d","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":"Parses and decodes a raw Terminal Aerodrome Forecast (TAF) string into structured JSON with forecast periods, wind, visibility, cloud layers, and validity times.","exampleAgentPrompt":"Can you decode this raw TAF for me: 'TAF KSFO 021720Z 0218/0324 28012KT P6SM FEW020 FM030400 30008KT P6SM SCT015' — I need the forecast periods, wind speeds, and cloud layers broken out clearly.","exampleUseCases":[{"title":"Parse TAF for flight planning","prompt":"I've got this raw TAF string for KJFK and I need to build out a flight plan — can you decode it and pull out each forecast period with the wind direction, speed, and visibility so I can check if conditions are suitable for my departure window? TAF KJFK 081755Z 0818/0924 18015KT 6SM -RA BKN040 FM082200 22020G35KT 4SM TSRA OVC025 TEMPO 0900/0904 1SM +TSRA OVC010"},{"title":"Extract cloud layers from TAF","prompt":"Can you parse this TAF for EGLL and just give me the cloud layers and ceiling heights for each forecast period? I want to know when conditions drop below 1500 feet so I can flag any IFR risk. TAF EGLL 101155Z 1012/1118 24015KT 9999 FEW018 BKN030 BECMG 1014/1016 18008KT SCT010 OVC015 TEMPO 1018/1022 3000 -SHRA BKN008"},{"title":"Interpret ATIS TAF string","prompt":"We just pulled this TAF off the ATIS broadcast at KDFW and the pilots are asking what it means — can you decode it into structured forecast periods so I can quickly walk through the wind, visibility, and any weather phenomena expected over the next 24 hours? TAF KDFW 150530Z 1506/1612 35010KT P6SM SKC FM151400 18012KT P6SM FEW025 FM152000 20018G28KT 5SM TSRA OVC030"}],"resultDescription":"A structured JSON object containing the station ICAO code, issuance time, validity window, amendment flag, and an array of forecast periods each with type (INITIAL, FM, TEMPO, BECMG, PROB), from/to times, wind direction and speed in knots, gust speed, visibility in statute miles, CAVOK flag, cloud layers (cover type and base altitude in feet), weather phenomena, and probability.","failureModes":["Malformed or empty TAF string returns a parsing error","Unsupported TAF format or non-standard encoding may produce incomplete period extraction","Missing required 'raw' field returns a 400-level error","Payment not settled via x402 protocol returns a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you have a raw TAF text string (from an ATIS, METAR source, or user input) and need it decomposed into machine-readable forecast periods for downstream processing, flight planning logic, or display. Prefer this over manual regex parsing or general-purpose LLM interpretation when structured, field-level accuracy is required for wind, visibility, and cloud data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:42:17.746Z","isFirstParty":false}