{"uid":"cap_2eymOe9zYAReZq28YN0au","slug":"waterpulse-supply-brief-1ce5e7a7","name":"WaterPulse Supply Brief","description":"Water supply intelligence for utility and investor agents. Covers reservoir storage, utility supply outlook, infrastructure investment, rate trajectory, drought restrictions, and a 5-year risk rating for any US city or region.","url":"https://waterpulse-henna.vercel.app/api/water/supply-brief","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"lang":{"type":"string","description":"en | es | fr | de | ja | zh | ko | pt | ar (default: en)"},"state":{"type":"string","description":"Two-letter US state code for USGS/drought data — e.g. AZ | NV | GA | CO"},"location":{"type":"string","description":"City or metro area — e.g. \"Phoenix AZ\" | \"Las Vegas NV\" | \"Atlanta GA\" | \"Denver CO\""}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"risk_rating":{"max":100,"note":"Supply risk elevated by Colorado River shortage but substantially mitigated by groundwater banking program and diversified portfolio","score":52,"rating":"Moderate"},"query_summary":{"state":"AZ","location":"Phoenix AZ","report_date":"2026-06-07"},"supply_overview":{"storage_pct":40,"primary_source":"Colorado River (CAP) — 36% | Salt River Project reservoirs — 32% | Groundwater — 22% | Recycled water — 10%","shortage_active":true,"shortage_detail":"Tier 2b Colorado River shortage — Arizona receives 21% CAP cut (512,000 acre-feet shortfall); Lake Mead 38% full, Lake Powell 42% full"},"utility_outlook":{"reserve_note":"Phoenix has been banking Colorado River water underground since 1996 — 2.7M acre-feet stored","reserve_years":100,"rate_trajectory":"Rates expected to increase 6-8% annually through 2028 to fund water security investments"},"five_year_outlook":"Manageable under current trajectory. Key risk: Lake Mead falling below elevation 895 (Tier 3 shortage) would trigger additional 17% CAP reduction not currently priced into utility plans.","current_restrictions":{"stage":"Stage 2 Voluntary + Tier 1 Mandatory","car_washing":"Commercial only, recirculating systems required","new_development":"100-year assured water supply certification suspended for new subdivisions in Scottsdale","outdoor_irrigation":"Limited to 3 days/week, 6am-8am"},"infrastructure_investment":"$1.2B committed 2025-2030: direct potable reuse plant (180MGD), wastewater reclamation expansion, groundwater recharge infrastructure"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JbZBTi38rV2_SpMuG86k_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a water supply intelligence brief for any US city or region, covering reservoir storage, utility outlook, infrastructure investment, rate trajectory, drought restrictions, and a 5-year risk rating.","exampleAgentPrompt":"Give me a full water supply brief for Phoenix, Arizona — I want reservoir storage, the utility supply outlook, any drought restrictions in effect, rate trajectory, and the 5-year risk rating so I can assess it for a long-term infrastructure investment.","exampleUseCases":[{"title":"Real estate due diligence for Sun Belt expansion","prompt":"I'm evaluating three potential office park locations in the Southwest and need to understand the water supply risks. Can you pull comprehensive water briefs for Scottsdale, Las Vegas, and Albuquerque? I especially need the 5-year risk ratings and rate trajectories so I can factor water costs and supply reliability into my investment decision."},{"title":"Municipal utility rate planning and forecasting","prompt":"We're a mid-sized water utility in Colorado and need to understand how our supply outlook compares to peer utilities in similar drought conditions. Get me water supply intelligence for Denver, Boulder, and Fort Collins — focus on reservoir levels, infrastructure investment signals, and rate trajectories so we can benchmark our rate-setting strategy."},{"title":"Climate resilience strategy for pension fund portfolio","prompt":"Our pension fund is reassessing climate risks across our real estate holdings in water-stressed regions. Can you give me detailed water supply briefs for Austin, Phoenix, and San Diego? I need the full picture — reservoir storage, drought restrictions, utility outlook, and especially those 5-year risk ratings so we can understand stranded asset risk in each market."}],"resultDescription":"A structured water supply intelligence brief including current reservoir storage levels, utility supply outlook, infrastructure investment signals, water rate trajectory, active drought restrictions, and a 5-year water risk rating for the requested US city or region.","failureModes":["Location not recognized or outside US coverage — returns error or empty result","No recent data available for the specified region — may return stale or partial data","Rate limit or payment failure via x402 — returns 402 Payment Required","Ambiguous city name with multiple matches — may return results for wrong municipality"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, multi-dimensional water supply intelligence brief for a specific US city or region — especially for utility planning, real estate investment due diligence, infrastructure risk assessment, or drought policy research. Prefer this over drought-only or streamflow-only endpoints when you need the full picture including rates, infrastructure investment signals, and a forward-looking 5-year risk score.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:37:06.932Z","isFirstParty":false}