Komunidad CRA APIClimate Risk Assessment
Komunidad CRA is the Philippines’ Climate Risk Assessment engine. Send a single latitude and longitude and receive the full picture of physical risk at that point: five hazard scores built from authoritative Philippine and global science, a blended Multi-Hazard Score, and a complete financial translation that prices the risk in pesos. The model measures how hard and how often nature strikes the location, how much of your asset stands in the way, what fraction of it would be lost, and what that costs every year. Every figure is deterministic, fully auditable, and traceable to its source dataset, from PHIVOLCS fault traces to CMIP6 climate projections.
A severe typhoon over an empty field is no risk. A fragile warehouse in a hazard-free valley is no risk. Risk exists only where all the pieces meet, so the CRA keeps them separate, scores each on its own evidence, and multiplies them into money at the end.
Computed by Komunidad from the coordinate alone: fault distances, flood depth classes, a century of cyclone tracks, volcanic reach models and CMIP6 projections. Also sets the annual probability of a damaging event.
Declared by you, per asset: building replacement value, contents, daily revenue, operating income and how critical the asset is to your operations. Exposure is the scale the other pillars multiply against.
Calibrated damage, downtime and probability curves indexed by the hazard score, then adjusted for the asset itself: construction type, building height, workforce size, insurance coverage and deductible.
The pillars combine into an expected annual loss in pesos and a 0–100 Financial Impact Score, per hazard and blended into one criticality-weighted figure, projected forward under climate scenarios.
Each domain returns a normalised 0–100 hazard score, blended into a single Multi-Hazard Score for the coordinate. Every value is grounded in published scientific datasets.
Seismic hazard from active-fault proximity, ground shaking and recent regional seismicity.
Volcanic threat from the nearest edifice: proximity, primary and secondary hazards, eruptive history.
Cyclone threat from the historical Western North Pacific track record near the point, incl. storm surge.
Rainfall-driven flood hazard at multiple return periods, plus coastal storm-surge inundation.
Forward-looking climate stress from downscaled projections of temperature and rainfall change.
Beyond the physical score, the API translates each hazard into an asset’s expected financial loss: a Financial Impact Score on the same 0–100 scale, per hazard and as a single combined figure, so risk can be compared and prioritised across a whole portfolio.
Each hazard’s score runs through an expected-annual-loss model using the asset’s own value, revenue, construction and insurance profile, returned as a 0–100 Financial Impact Score.
Every step is returned in the response: damage ratios, direct loss, business interruption, gross loss, net of insurance and expected annual loss. No black box, no hidden intermediate.
The five hazards combine into a single, criticality-weighted Final Financial Impact Score, comparable across assets for screening, prioritisation and disclosure reporting.
Scores are traceable to recognised scientific and government datasets, drawn from the Philippine and global open-data ecosystem.
One request flows through three stages, input to assessment to result, in real time.
Send any latitude and longitude in the Philippines, with an optional search radius, to a single REST endpoint. No dataset downloads, no GIS setup, no pre-processing on your side.
The engine reads authoritative government and scientific datasets at that exact point: USGS, PHIVOLCS, PAGASA, DOST Project NOAH and CMIP6. All five hazard domains are evaluated in parallel, including neighbourhood-aware flood and storm-surge exposure.
Receive normalised 0–100 scores for every hazard plus a single blended Multi-Hazard Score, each with a transparent breakdown, ready to plot on a map, rank across a portfolio, or integrate into your own risk models.
A focused REST API built for integration, from a single coordinate to a whole portfolio, hazard science through to financial impact.
A single request returns all five hazard scores plus a blended Multi-Hazard Score for any Philippine coordinate. Narrow it to one hazard or a subset with ?hazards=.
Turn each hazard into a per-asset Financial Impact Score and a single criticality-weighted Final score: expected annual loss with a full, auditable breakdown.
Score many coordinates in one request. Assess an entire book of assets and rank exposure across sites on a consistent 0–100 scale.
Get a lean summary by default, or the full detailed assessment with GeoJSON geometry for maps via include_geometry. The same source of truth either way.
Query capabilities and dataset availability, and monitor uptime with public liveness and readiness probes built for production operations.
API-key authentication, per-key rate limiting and CORS, with an OpenAPI schema, interactive Swagger console and ReDoc reference out of the box.
The interactive console lets you plot any Philippine coordinate and see every hazard score render on the map in real time. Authorize with your API key and explore.
A small, consistent REST surface. Authenticate once with your API key, then call any of these.
X-API-Key header, or click Authorize in the
interactive console before calling.
Parameters for GET /assess/:
| Parameter | Type | Required | Description |
|---|---|---|---|
lat | float | required | Latitude in decimal degrees (Philippine domain). |
lon | float | required | Longitude in decimal degrees (Philippine domain). |
radius_km | float | optional | Search radius, 1–1000 km. Defaults to 100. |
include_geometry | boolean | optional | When true, returns the full detailed assessment with map geometry (used by the interactive map). Defaults to false. |
scenario | string | optional | Climate pathway: SSP1-2.6, SSP2-4.5 or SSP5-8.5. Defaults to SSP5-8.5. |
GET /assess/{
"input": { "latitude": 14.5995, "longitude": 120.9842 },
"multi_hazard_score": 58.6,
"hazards": {
"earthquake": {
"score": 56.98,
"historical_seismic_m45_past_20yr": 42,
"nearest_fault_name": "Colosas Fault",
"nearest_fault_distance_km": 1.269,
"proximity_score": 82.67,
"ground_shaking_score": 67.87,
"liquefaction_score": 29.26,
"landslide_score": 61.86,
"ground_rupture_score": 0
},
"volcano": {
"score": 27.53,
"historical_activity_years": [2020, 2021, 2022],
"historical_activity_count": 5,
"proximity": {
"nearest_volcano_name": "Taal",
"nearest_volcano_distance_km": 8.742,
"volcano_status": "Active"
},
"primary_hazard": { "score": 3.44, "pyroclastic_flow_score": 36.71, "lava_flow_score": 1.31 },
"secondary_hazard": { "score": 45.02, "ashfall_score": 84.55, "lahar_score": 69.43 }
},
"cyclone": {
"score": 81.81,
"tropical_cyclones_count": 187,
"peak_category": "Super Typhoon",
"mean_gust_kph": 120.7,
"mean_wind_kph": 99.8,
"storm_surge_score": 100,
"track_density_tracks_per_year": 1.3169,
"track_density_score": 100
},
"climate": {
"score": 39,
"temperature": { "value_2020": 28.427, "value_2050": 29.427, "value_2100": 31.2 },
"precipitation": { "value_2020": 8.12, "value_2050": 9.42, "value_2100": 10.8 }
},
"flood": {
"score": 93.75,
"rp5_score": 75,
"rp25_score": 100,
"rp100_score": 100,
"storm_surge_score": 100
}
}
}