{"uid":"cap_MBpS7T1Tw19WfxTbFZT2M","slug":"nws-area-forecast-discussion-by-office-5af00d94","name":"NWS Area Forecast Discussion by Office","description":"NWS Area Forecast Discussion by forecast office - the meteorologists' own reasoning, key messages, near and long term outlook, aviation and marine sections","url":"https://saylorinnovations.com/api/weather/forecast-discussion?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":["office"],"properties":{"office":{"type":"string","description":"3-letter NWS forecast office code, e.g. LWX (Washington), OKX (New York), SEW (Seattle)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["office","sections"],"properties":{"url":{"type":"string","description":"Canonical URL"},"header":{"type":"string","description":"Product header lines with the office name and issue time as printed"},"issued":{"type":["string","null"],"description":"Time the discussion was issued (UTC)"},"office":{"type":"string","description":"3-letter forecast office code that was read"},"source":{"type":"string","description":"Data source the values come from"},"product":{"type":"string","description":"Product name"},"headline":{"type":["string","null"],"description":"Headline text"},"sections":{"type":"array","description":"Sections"},"issuing_office":{"type":["string","null"],"description":"Issuing office"},"section_titles":{"type":"array","description":"Section titles"}}}}}}},"responseSchema":null,"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_MqMkk6wNusWRwpsWJhwEJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the National Weather Service Area Forecast Discussion (AFD) for a given forecast office, including meteorologists' reasoning, key messages, near/long-term outlook, aviation, and marine sections.","exampleAgentPrompt":"Pull up the NWS Area Forecast Discussion for the New York forecast office (OKX) — I want to see the meteorologists' reasoning, key messages, and long-term outlook sections.","exampleUseCases":[{"title":"Daily weather briefing for pilots","prompt":"Get the Area Forecast Discussion from the Seattle NWS office (SEW) — specifically the aviation section so I can see what conditions the forecasters are flagging for today."},{"title":"Severe weather situational awareness","prompt":"What are the NWS meteorologists in Oklahoma City saying about the current weather pattern? Fetch the OUN forecast discussion and show me the key messages and near-term outlook."},{"title":"Coastal marine planning","prompt":"Pull the NWS forecast discussion for the Boston office (BOX) — I need the marine section to understand what the forecasters are thinking about conditions for this week."}],"resultDescription":"Returns a JSON object containing the 3-letter office code, full text header with office name and issue time, issue timestamp (UTC), headline, product name, data source, canonical URL, and an array of parsed sections with their titles — giving the complete Area Forecast Discussion as structured, machine-readable data.","failureModes":["Invalid or unrecognized office code returns an error or empty result","NWS API outage or data unavailability causes upstream failure","Office code provided in wrong format (e.g. lowercase or 4 letters) may fail validation","Newly created or discontinued forecast offices may not have current data","Rate limiting or payment failure at the x402 layer returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need the full meteorologist-authored narrative behind a regional forecast — including forecaster reasoning, key messages, aviation and marine sub-sections — rather than just structured forecast data (temperatures, precipitation probabilities). It is ideal for agents that need to explain *why* weather is expected to behave a certain way, or that serve aviation, marine, or emergency management audiences who rely on the AFD for professional situational awareness.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:38:27.128Z","isFirstParty":false,"canonicalSlug":"nws-area-forecast-discussion-by-office-5af00d94"}