Skip to content

BirdsEyeView, developed in partnership with the European Space Agency

Developer documentation

CERA® API

Natural-catastrophe and weather hazard, delivered at the point of underwriting. One RESTful API returns the full exceedance curve (threshold, probability and return period) for any location on Earth, for every peril your key is licensed for.

Daily perils
12
plus expanding & lite modes
Per sync call
25
peril-event combinations
Per batch upload
100k
rows of scheduled risks
Coverage
Global
weather & NatCat models

What the API returns

Most hazard services return a single score or a lookup value. CERA® requests return the full hazard exceedance curve for the location: an array of thresholds, the probability of exceeding each threshold, and the equivalent return periods. That is the form a pricing actuary or exposure manager can build on: it feeds your own vulnerability curves and loss models rather than replacing them.

Two ways to work

Mode Endpoints Latency Limits Use when
Synchronous /v1/lite, /v2/in-depth Low (request/response) ≤ 25 peril-event combinations per request Single-risk lookups at point of underwriting; interactive tooling
Asynchronous /v1/in-depth/batch Minutes, depending on size Up to 100,000 rows per upload; key-tier dependent Full schedules of risks, portfolio sweeps, renewal books

Base URL

https://prod-external-weather-api.birdseyeviewtechnologies.com

All endpoints are relative to this base URL. All requests must be made over HTTPS.