The Previsico flood-forecast API.
The Previsico API gives your systems automated access to everything in the dashboard: the latest asset-level flood alerts, hour-by-hour risk timelines, real-time lookback, flood-map layers, sensor readings and full asset lists. Integrate the Flood Intel Platform directly into your own risk-management platform, monitor changing flood risk, update assets, and render forecasted or observed flooding on your own maps, without a manual login.
Technical specs
Built to a simple, standards-based contract.
| Spec | Value |
|---|---|
| Protocol | REST-style URL scheme |
| Authentication | Key-based; separate production and development keys |
| Data cadence | New data every hour; endpoints suited to polling for the latest forecasts |
| Response format | JSON (all endpoints) |
| Map tiles | Mapbox Vector Tiles (tile endpoint) |
| Asset upload | GeoJSON; asset processing monitorable for success or validation failures |
| Resolution | Property-level flood-map layers (all supported regions) |
| Forecast window | 48h forecast + 24h lookback (Instacast) risk timelines |
Last updated 20 August 2026. Rate limits and plan-level gating are not yet published, talk to an engineer about the specifics for your integration. Coverage is limited to Previsico's supported regions.
Endpoints
Every insight in the dashboard, available programmatically.
Asset-level flood alerts
The latest flood or severe-flood risk per asset, with probabilities and timelines.
Risk timelines
Hour-by-hour risk across the past 24 hours (Instacast) and the next 48 hours (forecast).
Flood-map layers
Download map tiles to render forecasted or observed flooding in your own GIS or mapping systems.
Sensor data
Readings from installed Previsico sensors.
Sensor metadata
Device name, threshold set and location for every sensor.
Asset management
Upload or refresh asset lists (GeoJSON) and retrieve all stored assets.
Start integrating.
The Previsico API is built for engineers integrating flood intelligence into an existing risk-management platform. Full technical documentation is available to teams evaluating integration, covering:
- Quickstart & authentication, get a key and make your first request.
- API reference, every endpoint, from asset alerts to sensor data.
- Map-tile & GeoJSON guides, render flood layers and manage assets.
Example request
GET /v1/assets/{assetId}/warningsAuthorization: Api-Key <YOUR_KEY>200 OK{ "assetId": "...", "severity": "flood", // flood (>5cm) | severe-flood (>20cm) "likelihood": "high", // low 20-40% | medium 40-60% | high >60% "medianDepthCm": 12, "window": { "forecastHours": 48, "lookbackHours": 24 }}
Illustrative example showing the shape of a warnings response, ask an engineer for full reference examples.
Integrated into Liberty's Risk Reduce portal.
Previsico's partnership with Liberty Specialty Markets delivers the Flood Intel Platform to Liberty's insureds through its Risk Reduce portal, integrated via the Previsico API.
“Previsico's technology allows us to use data intelligently and integrate it seamlessly into our risk management portal for customers. This provides very real value to our insureds.”
Carol Baker, Head of Digital, Liberty Specialty Markets
Security & compliance
Practical safeguards, built in.
We list only what we can confirm. Formal certifications will be published here once verified, talk to an engineer about the compliance requirements for your integration.
- GDPR-compliant data handling
- Key-based API authentication
Verify the fit, then talk to us.
Talk to one of our engineers about integrating the Flood Intel Platform with your risk-management systems, or request a demo to see it in action.