{"uid":"cap_6MHNVqbCC0aOHpEGf-7hF","slug":"waterpulse-flood-risk-api-8e0ceee5","name":"WaterPulse Flood Risk API","description":"Real-time flood risk for insurance and emergency-planning agents. Combines USGS stream gauges, Open-Meteo precipitation forecasts, and FEMA flood-zone context into current river conditions and actionable guidance.","url":"https://waterpulse.theaslangroupllc.com/api/water/flood-risk","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 data enrichment — e.g. TN | IA | TX"},"location":{"type":"string","description":"City, county, or river name — e.g. \"Nashville TN\" | \"Mississippi River Iowa\" | \"Houston Harris County\""}}}},"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":{"query_summary":{"state":"TN","location":"Nashville TN","risk_horizon":"72 hours"},"risk_assessment":{"72h_outlook":"Moderate — 40-60% probability of reaching action stage","current_risk":"Low-Moderate","historical_context":"Cumberland River has exceeded 40 ft (flood stage) 6 times since 2000, including catastrophic 2010 event (51.9 ft)"},"upstream_factors":{"dam_releases":"Army Corps releasing 22,000 cfs at Old Hickory — elevated downstream levels expected","soil_saturation":"High (>85%) — upstream of Cordell Hull Dam","precipitation_72h_in":2.1},"property_guidance":{"nfip_note":"22% of Nashville flood claims come from outside high-risk zones. Consider coverage if within 1 mile of Cumberland or major tributary.","fema_zones_at_risk":["AE","AO"],"preparation_checklist":["Move valuables above ground level","Test sump pump","Locate flood shutoffs","Review NFIP policy limits"]},"current_conditions":{"stage_ft":28.4,"condition":"Below action stage — monitoring recommended","primary_river":"Cumberland River","flood_stage_ft":40,"action_stage_ft":30,"pct_of_flood_stage":71}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1gsBkzPh4LEyrxsIZmMP3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time flood risk assessments combining USGS stream gauges, precipitation forecasts, and FEMA flood-zone data for insurance and emergency planning.","exampleAgentPrompt":"What's the current flood risk for the area around Austin, Texas? I need USGS stream gauge conditions, any precipitation-driven flood threat for the next few days, and the FEMA flood zone context — I'm underwriting a property there.","exampleUseCases":[{"title":"Insurance underwriting for riverfront property","prompt":"I'm reviewing an underwriting case for a home in Memphis near the Mississippi River. Can you pull the current flood risk assessment including stream gauge readings, the precipitation forecast for the next week, and what FEMA flood zone it's in? I need to know if we should adjust the premium or require additional mitigation."},{"title":"Emergency response planning for county officials","prompt":"We're an emergency management team in North Carolina preparing for next week's weather system. Can you give us real-time flood risk data for our county — stream conditions, precipitation-driven flood probability, and FEMA zone breakdowns? We need to know which areas might need pre-positioning resources or evacuation routes."},{"title":"Portfolio risk assessment across regions","prompt":"We manage an insurance portfolio with properties across Louisiana and Mississippi. Can you run a flood risk check for our highest-value properties in flood-prone areas? I need current USGS gauge levels, the precipitation outlook, and FEMA classification so we can prioritize which accounts need immediate review."}],"resultDescription":"Returns current river and stream conditions from USGS gauges, precipitation-driven flood probability from Open-Meteo forecasts, FEMA flood-zone classification for the queried location, a composite flood risk rating, and actionable guidance for insurance underwriting or emergency response decisions.","failureModes":["Location outside USGS gauge coverage — no stream gauge data available for remote or ungauged areas","FEMA flood zone data not available for non-US locations","Open-Meteo forecast unavailable due to upstream outage — precipitation component may be missing","Invalid or unparseable location input returns 400 error","Payment not processed (x402 protocol failure) returns 402 error","Rate limiting if too many requests in a short window"],"whenToPreferThis":"Choose this endpoint when you need a combined, real-time flood risk signal that fuses live USGS stream gauge readings, short-term precipitation forecasts, and FEMA regulatory flood-zone context in a single call — especially for US insurance underwriting, property risk assessment, or emergency planning workflows. Prefer it over raw USGS or FEMA APIs when you need an aggregated, actionable risk score rather than raw hydrological data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:31:43.557Z","isFirstParty":false}