{"uid":"cap_GWpl8tjD4tRTqqUJU_y0G","slug":"waterpulse-us-city-water-supply-brief-b0bb6ea8","name":"WaterPulse US City Water 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.theaslangroupllc.com/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_Tof0lTh8IPJ5WXPcrbkxw","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 supply outlook, infrastructure investment, rate trajectory, drought restrictions, and a 5-year risk rating.","exampleAgentPrompt":"Can you pull a full water supply intelligence brief for Phoenix, Arizona — I need the reservoir storage levels, utility supply outlook, drought restrictions, infrastructure investment picture, rate trajectory, and the 5-year risk rating?","exampleUseCases":[{"title":"Evaluate investment risk for real estate portfolio","prompt":"I'm looking at acquiring commercial properties in Austin and Las Vegas — can you get me the water supply intelligence briefs for both cities so I can assess the 5-year supply risk and rate trajectory before we commit?"},{"title":"Plan infrastructure spending for municipal utilities","prompt":"We need to decide where to allocate our next round of infrastructure investments across the Southwest. Pull water supply briefs for Albuquerque, Phoenix, and Las Vegas — I especially need the reservoir levels, rate trajectories, and any drought restrictions to guide our planning."},{"title":"Monitor drought exposure in investment portfolio","prompt":"Our fund has utilities and real estate exposure in California. Can you give me current water supply briefs for Los Angeles, San Francisco, and San Diego — specifically the drought restrictions, supply outlook, and 5-year risk ratings so we know what we're exposed to?"}],"resultDescription":"A structured intelligence brief containing current reservoir storage levels, utility supply outlook, infrastructure investment summary, projected water rate trajectory, active drought restrictions, and a 5-year water supply risk rating for the specified US city or region.","failureModes":["Location not recognized or outside US coverage — returns 404 or empty result","Insufficient data for rural or very small localities — partial brief returned","Payment not processed or x402 auth failure — 402 response blocking data return","Rate limit exceeded — 429 response if too many calls in short period"],"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, infrastructure investment due diligence, or drought risk assessment. Prefer this over specialized sibling endpoints (groundwater, streamflow, drought status) when you need the all-in-one supply outlook and risk rating rather than a single data stream.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:39:18.548Z","isFirstParty":false}