{"uid":"cap_QMikfORMRBXMCJ9aozpTz","slug":"tbs-weather-climate-api-river-discharge-flood-risk-forecast-7184f7f2","name":"TBS Weather & Climate API – River Discharge & Flood Risk Forecast","description":"River discharge and flood-risk forecast (Copernicus GloFAS, 5 km grid) for the nearest river to any lat/lon. Returns current river discharge in cubic meters per second (m3/s) plus mean, median, max, min and 25/75 percentiles. Hydrology and natural-disaster data for flood forecasting, insurance, agriculture and river logistics.","url":"https://x402.tbs-digital.com/weather/flood?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","properties":{"lat":{"type":"number","description":"Latitude -90..90 (requires lon)"},"lon":{"type":"number","description":"Longitude -180..180 (requires lat)"},"city":{"type":"string","description":"City name (alternative to lat/lon)"},"timezone":{"type":"string","description":"Optional IANA timezone"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"flood":{"type":"object"},"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"source":{"type":"string"},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"name":{"type":"string"},"country":{"type":"string"}}},"request_id":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"flood":{"river_discharge_m3s":42.5,"river_discharge_max_m3s":61,"river_discharge_min_m3s":22.4,"river_discharge_p25_m3s":31,"river_discharge_p75_m3s":47,"river_discharge_mean_m3s":38,"river_discharge_median_m3s":37.2},"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"source":"open-meteo","location":{"lat":48.85,"lon":2.35,"name":"Paris","country":"FR"},"request_id":"0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55","generated_at":"2026-08-09T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P2QT6F_fmAlYyRUdfAPjN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current river discharge (m³/s) and flood-risk statistics (mean, median, max, min, percentiles) for the nearest river to any lat/lon or city, powered by Copernicus GloFAS at 5 km grid resolution.","exampleAgentPrompt":"What's the current river discharge and flood risk near Paris, France? Give me the GloFAS statistics including mean, median, and the 25/75 percentiles for the nearest river.","exampleUseCases":[{"title":"Flood risk check for insurance underwriting","prompt":"I need to assess flood risk for a property at latitude 48.85, longitude 2.35 — can you pull the current river discharge and flood statistics from the nearest river so I can evaluate the risk for a new insurance policy?"},{"title":"River logistics route planning","prompt":"We're planning a barge route along the Rhine near Cologne — can you check the current river discharge levels and percentile statistics so we know if conditions are safe for navigation?"},{"title":"Agricultural flood alert monitoring","prompt":"Our farm is near the Po River in Italy, around latitude 44.9, longitude 11.4 — can you get the latest flood risk forecast and discharge data so we can decide whether to move equipment out of the floodplain?"}],"resultDescription":"Returns a JSON object with the flood sub-object containing current river discharge in m³/s plus statistical measures (mean, median, max, min, 25th and 75th percentiles), alongside location metadata (lat, lon, name, country), data source attribution, request ID, and generation timestamp.","failureModes":["No nearby river found for given coordinates — returns empty or null flood object","Invalid latitude/longitude values outside -90..90 or -180..180 range — validation error","Unknown city name that cannot be geocoded — returns error or empty result","Missing both lat/lon and city parameters — returns 400-style validation error","GloFAS data temporarily unavailable — upstream data source timeout or gap"],"whenToPreferThis":"Choose this endpoint when you need river discharge and flood-risk hydrological data specifically from the Copernicus GloFAS model at 5 km resolution. It is the right choice for flood insurance risk assessment, agricultural flood planning, river logistics, and natural disaster preparedness workflows where probabilistic discharge statistics (percentiles) are needed. Prefer it over generic weather APIs that lack hydrological river data, or over coastal/marine endpoints when the risk is riverine rather than oceanic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:50:38.832Z","isFirstParty":false,"canonicalSlug":"tbs-weather-climate-api-river-discharge-flood-risk-forecast-7184f7f2"}