Geosapiens API – Essential
Welcome. This guide is for people who integrate or call the Essential API: you send a location (address or coordinates) and receive flood hazard scores, flood risk scores, and a wildfire hazard score for that point. There is no financial or loss (AAL/PML) data in this product.
The Essential API is an optimized version of the Geosapiens API: it returns only these scores, so responses are typically faster than the full API that also computes building losses and accepts financial inputs.
What’s in this guide
| Section | What you’ll learn |
|---|---|
| Getting started | What you need and the basic request flow |
| Authentication | How to send your access token |
| Address endpoint | Query using a postal address |
| Coordinates endpoint | Query using latitude and longitude |
Waterbody search (wb_window) |
How the API behaves when the location falls on water on the flood maps |
| Output values | Each score field, normal ranges, and special status codes |
| Error handling | Common errors and what they mean |