Komunidad CRA APIClimate Risk Assessment
Built for the Philippines · Climate Risk & Financial Metrics
Komunidad CRA API

One coordinate in. A complete climate risk profile out.

Komunidad CRA is the Philippines’ Climate Risk Assessment engine. Send a single latitude and longitude and receive five hazard scores built from authoritative Philippine and global science, a blended Multi-Hazard Score, and a financial translation that prices the risk in pesos. Every figure is deterministic, fully auditable, and traceable to its source dataset.

Risk = × × →
H · how hard, how often E · what is at stake V · what fraction is lost F · what it costs per year
0
Hazard engines
0
Authoritative datasets
0–100
One comparable scale
0
Climate scenarios
₱
Expected annual loss

Four pillars, one number that means something

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.

H · Hazard

How hard, how often

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.

E · Exposure

What is at stake

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.

V · Vulnerability

What fraction is lost

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.

F · Financial impact

What it costs per year

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.


Five hazard domains, one composite

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.

0–100

Earthquake

Seismic hazard from active-fault proximity, ground shaking and recent regional seismicity.

Fault proximityGround shakingLiquefactionLandslideRupture
USGS & PH fault dataset
0–100

Volcanic

Volcanic threat from the nearest edifice: proximity, primary and secondary hazards, eruptive history.

Pyroclastic flowLava flowAshfallLahar
Smithsonian GVP & PHIVOLCS
0–100

Tropical Cyclone

Cyclone threat from the historical Western North Pacific track record near the point, incl. storm surge.

Wind & gustTrack densityPeak categoryStorm surge
Cyclone History (CLIMADA) & PAGASA
0–100

Flood

Rainfall-driven flood hazard at multiple return periods, plus coastal storm-surge inundation.

RP5 / RP25 / RP100Depth classStorm surge
Project NOAH hazard maps
0–100

Climate

Forward-looking climate stress from downscaled projections of temperature and rainfall change.

2020 · 2050 · 2100TemperaturePrecipitationSSP scenarios
CMIP6 Projections (ACCESS-CM2)

From hazard to financial impact

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.

Per asset

Financial Impact Score

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.

Full breakdown

Loss you can audit

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.

Portfolio ready

One final score

The five hazards combine into a single, criticality-weighted Final Financial Impact Score, comparable across assets for screening, prioritisation and disclosure reporting.


Built on authoritative science

Scores are traceable to recognised scientific and government datasets, drawn from the Philippine and global open-data ecosystem. Swipe or use the arrows to browse.

USGS
Earthquake Hazards

The U.S. Geological Survey earthquake catalog of global magnitudes, depths and epicenters. It anchors the recent regional seismicity count, epicentral density and the distance from your point to historical events that drive the earthquake score.

PHIVOLCS
Seismic & Volcanic

The Philippine Institute of Volcanology and Seismology, the national authority for active-fault traces, earthquake monitoring and volcano status. Its data grounds the fault-proximity, ground-shaking and volcanic layers in official Philippine science.

HazardHunterPH
DOST-GIA Screening

The official DOST-GIA multi-hazard screening service for the Philippines. It aligns the platform’s seismic, volcanic and hydro-meteorological assessment with recognised government hazard-identification standards.

CLIMADA
Cyclone Modelling

The open-source CLIMADA climate-risk platform from ETH Zürich. It ingests and processes the historical tropical-cyclone track record into per-storm wind, gust and category metrics used by the cyclone score.

PAGASA
National Weather Service

The Philippine Atmospheric, Geophysical and Astronomical Services Administration, the national authority for tropical-cyclone categories and the Storm Surge Advisory (SSA) inundation maps behind the surge layer.

Project NOAH
DOST Hazard Mapping

DOST’s Nationwide Operational Assessment of Hazards: high-resolution flood and storm-surge hazard maps modelled over LiDAR / IfSAR terrain across the 5-, 25- and 100-year rain return periods.

Cyclone History
IBTrACS Archive

The IBTrACS best-track archive holds over a century of Western North Pacific tropical-cyclone positions and intensities. It powers track-density, peak-category and mean-wind analysis around each coordinate.

Smithsonian
Volcanic (GVP)

The Smithsonian Global Volcanism Program, a worldwide eruption chronology with volcano types and activity status. It feeds the volcanic hazard weighting and the historical-activity component.

CMIP6 Projections
Climate Modelling

Downscaled CMIP6 (ACCESS-CM2) climate projections of near-surface temperature and precipitation for 2020, 2050 and 2100 across the SSP1-2.6, SSP2-4.5 and SSP5-8.5 emission pathways.

Copernicus
ERA5 / EU Earth Obs.

The EU Copernicus programme provides open ERA5 reanalysis and Earth-observation datasets that complement and cross-validate the projected climate signals over the Philippine domain.

Mapbox
Interactive Mapping

Mapbox GL vector basemaps and rendering power the interactive hazard console, visualising scores, faults, epicenters, cyclone tracks and flood / surge layers in real time.


From a coordinate to a risk profile

One request flows through three stages, input to assessment to result, in real time.

1Input

Locate

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.

2Assessment

Assess

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.

3Result

Score

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.


Everything you need to score risk at scale

A focused REST API built for integration, from a single coordinate to a whole portfolio, hazard science through to financial impact.

Assess

One call, whole profile

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=.

Financial

Hazard to money

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.

Batch

Portfolio scoring

Score up to 100 coordinates in one request. Assess an entire book of assets and rank exposure across sites on a consistent 0–100 scale.

Responses

Compact or map-detailed

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.

Discovery

Metadata & health

Query capabilities and dataset availability, and monitor uptime with public liveness and readiness probes built for production operations.

Access

Secure & documented

API-key authentication, per-key rate limiting and CORS, with an OpenAPI schema, interactive Swagger console and ReDoc reference out of the box.

Try it live on the interactive map

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.

The endpoints

A small, consistent REST surface. Authenticate once with your API key, then call any of these. Tap an endpoint for details.

Lists the five hazard engines, their data sources and whether each dataset is currently loaded. Useful for feature discovery and for confirming coverage before you send a batch.

GET /api/v1/hazards/ X-API-Key: <your key>

The main endpoint. Returns all five hazard scores and the blended Multi-Hazard Score for a point. Pass hazards= to assess a subset (the composite is omitted when you do), or include_geometry=true for map-ready GeoJSON.

GET /api/v1/hazards/assess/?lat=14.5995&lon=120.9842&radius_km=100

Runs one engine and returns just that block. {hazard} is one of earthquake, volcano, cyclone, flood or climate.

GET /api/v1/hazards/assess/flood/?lat=14.5995&lon=120.9842

Send 1–100 points in one JSON body and receive a result per point, with a shared radius_km and optional hazards subset. Ideal for portfolio screening.

POST /api/v1/hazards/assess/batch/ { "points": [ { "lat": 14.5995, "lon": 120.9842 }, { "lat": 10.3157, "lon": 123.8854 } ], "radius_km": 100 }

Combines the hazard score at a coordinate with your declared asset profile (value, revenue, construction, insurance) and returns the expected annual loss with a full, auditable breakdown and a 0–100 Financial Impact Score.

POST /api/v1/hazards/financial/flood/ { "lat": 14.5995, "lon": 120.9842, ...asset profile }

Runs the financial model for all five hazards and blends them into one criticality-weighted Final Financial Impact Score, projectable under a climate scenario and target year.

POST /api/v1/hazards/financial/ { "lat": 14.5995, "lon": 120.9842, ...asset profile }

No authentication required. /health/ answers as soon as the process is up; /health/ready/ confirms the hazard datasets are loaded and the service can take traffic.

GET /api/v1/hazards/health/ GET /api/v1/hazards/health/ready/
Authentication required for all endpoints except the health probes. Send your API key in the X-API-Key header, or click Authorize in the interactive console before calling.

Build a request

Set the coordinate and options; the snippet updates live. Copy it into your terminal or code.

Parameters

For GET /assess/. Coordinates should fall within the Philippine domain.

Outside the Philippine domain (about 4°–21° N).
Outside the Philippine domain (about 116°–127° E).

                

Parameters for GET /assess/:

ParameterTypeRequiredDescription
latfloatrequiredLatitude in decimal degrees (Philippine domain).
lonfloatrequiredLongitude in decimal degrees (Philippine domain).
radius_kmfloatoptionalSearch radius, 1–1000 km. Defaults to 100.
hazardsstringoptionalComma-separated subset, e.g. earthquake,flood. When set, multi_hazard_score is omitted.
include_geometrybooleanoptionalWhen true, returns the full detailed assessment with map geometry (used by the interactive map). Defaults to false.
scenariostringoptionalClimate pathway: SSP1-2.6, SSP2-4.5 or SSP5-8.5. Defaults to SSP5-8.5.
Example response: 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
    }
  }
}