Clear by design
A useful answer in one request
Send a coordinate and radius. Receive a compact result with the latest processed timestamp, coverage state, and rain intensity when current radar data is available.
coverage: 1Current radar data is available
coverage: 0Radar data is temporarily unavailable
coverage: -1The location is outside supported coverage
Example request
GET / POST
https://app.rain-alarm.com/api/v1/rain
api_keyYOUR_API_KEY
radius20
lat45.5152
lon-122.6784
200 OKapplication/json
{
"coverage": 1,
"intensity": 7,
"updated": 1783778400000
}
Intensity levels 1–12
Example response · Level 7: > 12 mm/h
Minimum estimated rain rate by level
- 1> 0.2 mm/h
- 2> 0.3 mm/h
- 3> 0.6 mm/h
- 4> 1.3 mm/h
- 5> 3 mm/h
- 6> 6 mm/h
- 7> 12 mm/h
- 8> 24 mm/h
- 9> 50 mm/h
- 10> 100 mm/h
- 11> 205 mm/h
- 12> 420 mm/h
The example shows the intended production API shape. Distance to precipitation, precipitation-covered area, and types within the radius—rain, mixed precipitation, snow, or freezing rain—could be added as optional fields. Authentication, response fields, and delivery options are finalized for each integration.