{"uid":"cap_qR-t8v_rqdvKM-s96PM2f","slug":"invoket-batch-weather-forecast-faef2809","name":"Invoket Batch Weather Forecast","description":"Before your agent plans across a whole network — fleet routing, multi-site operations, portfolio hedging: 2 m temperature, precipitation and 10 m wind forecasts for up to 500 point + lead-time queries in one call, from the deterministic NOAA GFS run (~16 days). Each query takes lat+lon or a city name plus an optional lead selector (omitted, it defaults to the current analysis time); an uncovered item is flagged via per-item coverage instead of failing the batch.","url":"https://api.invoket.com/weather/forecast/batch","method":"POST","headers":{},"bodySchema":{"type":"object","required":["queries"],"properties":{"queries":{"type":"array","description":"Array of point/lead-time queries resolved in one settlement. Its length is priced per unit (base + N x unit), capped at 500; a batch over 500 is rejected with 400. Each item takes a point (lat + lon, or a city name) and at most one lead selector (omitted = current analysis time)."}}},"responseSchema":{"type":"object"},"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_SkFto9FQMlKV70iZNgIrk","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 weather forecasts for multiple locations in a single request, resolved from official sources with provenance included in every response.","exampleAgentPrompt":"Can you get me the current weather forecast for New York, London, Tokyo, and Sydney all at once — I need it with source provenance included so I know where the data came from?","exampleUseCases":[{"title":"Multi-city logistics weather check","prompt":"Before we route our delivery drivers tomorrow, can you pull weather forecasts for Chicago, Dallas, Atlanta, Denver, and Seattle all at once so we can flag any severe conditions?"},{"title":"Travel itinerary weather briefing","prompt":"I'm planning trips to Paris, Barcelona, Rome, Amsterdam, and Lisbon — can you grab the current weather forecast for all five cities in one shot?"},{"title":"Agent pre-action field condition verification","prompt":"Before my agent dispatches field crews, check the weather at coordinates 51.5,-0.12 and 48.85,2.35 and 40.71,-74.01 and tell me what conditions are expected, with provenance on each answer."}],"resultDescription":"An object containing weather forecast data for each queried location, including conditions, temperatures, and lead-time forecasts, along with provenance metadata indicating the official source used for each result.","failureModes":["Batch size exceeds 500 queries — returns HTTP 400 rejection","Invalid or unresolvable location (bad lat/lon or unknown city name) — individual query may fail or return null","Unparseable lead-time selector — query item rejected","Payment not settled via x402 — request not processed","Upstream official weather source unavailable — may return partial results or error"],"whenToPreferThis":"Prefer this endpoint when an AI agent needs weather forecasts for multiple locations simultaneously and requires provenance on each result for audit or verification purposes. It is especially suited for pre-action checks where a single settlement covers all queries cost-efficiently (one flat fee up to 500 locations). Choose it over single-location APIs when batching is needed, and over generic weather APIs when source attribution is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:48:10.062Z","isFirstParty":false}