A geospatial hazard assessment API built on the Komunidad CRA methodology. Provide a coordinate and receive a combined risk profile — historical earthquake activity, active fault proximity, 0–100 Volcanic and Earthquake Hazard Scores, and historical tropical-cyclone counts — in a single request.
The Swagger UI includes an Interactive Hazard Map — plot any coordinate and see faults, earthquakes, the nearest volcano, and live score computations.
The API turns a single geographic point into an actionable hazard snapshot by combining authoritative external data with a curated Philippine fault dataset.
Submit a latitude and longitude with an optional search radius in kilometres.
Query the USGS catalog for magnitude 5.0+ events since 1950 and the nearest active fault.
A 0–100 score from the nearest volcano: proximity, primary & secondary hazards, and history.
A 0–100 score from fault proximity, ground shaking (PGA), secondary hazards, and epicentral density.
Count of historical Western North Pacific cyclones (IBTrACS, 1884–2025) whose track passes within the radius.
Each hazard is a weighted composite on a 0–100 scale. The response also returns the full per-model breakdown — every formula, its inputs, the computed value, and reference links.
Based on the nearest volcano, scaled by a weight W
(Active = 1.0, Potentially Active = 0.5).
Combines fault proximity, ground shaking, secondary hazards and historical seismicity.
One request, one combined hazard assessment.
X-API-Key header. In the Swagger UI, click Authorize and paste
your key before trying the endpoint.
| Parameter | Type | Required | Description |
|---|---|---|---|
lat |
float | required | Latitude in decimal degrees (−90 to 90). |
lon |
float | required | Longitude in decimal degrees (−180 to 180). |
radius_km |
float | optional | Earthquake search radius, 1–1000 km. Defaults to 100. |
include_geometry |
boolean | optional | When true, adds map geometry — earthquake epicenters, the nearest fault line, and the nearest volcano point. Defaults to false. |
{
"coordinates": { "latitude": 7.19, "longitude": 125.46 },
"hazards": {
"earthquake_history": {
"search_radius_km": 100.0,
"historical_events_since_1950": 104
},
"fault_lines": {
"nearest_active_fault_km": 1.269,
"risk_level": "High",
"nearest_fault": {
"name": "Dacudao Fault",
"fault_type": "Sinistral",
"catalog_id": "PHL_2",
"catalog_name": "philippines"
}
},
"volcanic_hazard": {
"nearest_volcano_km": 8.742,
"weight_modifier": 1.0,
"component_scores": {
"proximity": 25, "primary_hazards": 3.44,
"secondary_hazards": 45.02, "historical_activity": 40
},
"volcanic_hazard_score": 27.53
// + hazard_models, references, nearest_volcano …
},
"earthquake_hazard": {
"earthquake_hazard_score": 56.98,
"component_scores": {
"proximity": 82.67, "ground_shaking": 67.87,
"secondary_hazards": 30.37, "historical_activity": 25
},
"inputs": {
"nearest_active_fault_km": 1.269,
"earthquakes_within_50km": 9,
"nearest_epicenter_km": 16.825,
"earthquake_density": 0.00331
}
// + hazard_models (proximity, ground_shaking,
// secondary_hazards, historical_activity) …
},
"tropical_cyclones": {
"available": true,
"count": 187,
"coverage_years": "1884-2025",
"basin": "Western North Pacific",
"nearest_storm": { "name": "HAIYAN", "season": 2013, "distance_km": 4.512 }
}
}
}
Scores are derived from authoritative datasets. Every hazard sub-model in the response carries its own reference links for verification.
Magnitude 5.0+ events since 1950 (ANSS ComCat), for seismicity and epicentral density.
Curated active fault lines for proximity, ground shaking, landslide and rupture models.
Volcano status, eruption history and danger zones for the Volcanic Hazard Score.
Western North Pacific tropical-cyclone tracks (1884–2025) for historical cyclone counts.