API Endpoints
/api/v1/climate-risk/
Assess physical climate risk for a single location. Returns hazard ratings, composite score, and scenario projections.
/api/v1/climate-risk/batch/
Process multiple coordinates in a single request. Optimized for portfolio-level risk assessment.
Request & Response Examples
Request
POST /api/v1/climate-risk/ Content-Type: application/json Authorization: Bearer YOUR_API_KEY { "latitude": 19.0760, "longitude": 72.8777, "scenarios": ["ssp245", "ssp585"], "time_horizons": ["2030", "2050"] }
Response
{
"status": "success",
"data": {
"composite_risk_score": 7.2,
"risk_category": "High",
"hazard_ratings": {
"coastal_flood": { "score": 8.5, "category": "Very High" },
"riverine_flood": { "score": 6.2, "category": "High" },
"extreme_heat": { "score": 7.8, "category": "High" },
"tropical_cyclone": { "score": 7.0, "category": "High" },
"water_stress": { "score": 5.5, "category": "Moderate" }
},
"location_context": {
"elevation_m": 14,
"coastal_distance_km": 2.3,
"terrain": "Coastal urban"
},
"scenario_projections": {
"ssp245_2050": { "composite_score": 7.8 },
"ssp585_2050": { "composite_score": 8.4 }
}
}
}
12 Physical Climate Hazards
Coastal Flood
Riverine Flood
Extreme Heat
Tropical Cyclone
Extreme Wind
Drought
Water Stress
Wildfire
Extreme Cold
Hail
Landslide
Lightning
Key Response Fields
composite_risk_score |
Overall risk score (0-10) combining all hazard ratings weighted by local relevance |
hazard_ratings |
Individual scores and categories for each of the 12 climate hazards |
scenario_projections |
Future risk scores under SSP2-4.5 and SSP5-8.5 scenarios for 2030, 2040, 2050, 2060 |
location_context |
Geographic context including elevation, coastal distance, terrain type, and basin information |
water_stress_analysis |
Detailed water stress metrics including baseline stress, future projections, and watershed data |
Technical Specifications
Common Use Cases
Real Estate Due Diligence
Screen property acquisitions for climate exposure. Assess flood, heat, and storm risk before investment decisions.
TCFD Reporting
Generate climate risk data for TCFD disclosures. Scenario analysis ready data for regulatory compliance.
Insurance Underwriting
Enrich underwriting workflows with location-level climate risk scores. Improve pricing accuracy with hazard-specific data.
Prefer a Web Interface?
Try our Climate Risk tool for instant physical risk assessment with no coding required.
Questions About Climate Risk API Integration?
Book a call to discuss your climate risk assessment requirements and integration approach.
Frequently Asked Questions
What climate scenarios does the API support?
The API supports two IPCC SSP scenarios: SSP2-4.5 (moderate emissions) and SSP5-8.5 (high emissions). You can request projections under either or both scenarios.
How are composite risk scores calculated?
Composite scores weight individual hazard ratings by local relevance. A coastal location weights flood and cyclone higher, while an inland location weights drought and wildfire higher. Scores range from 0-10.
What time horizons are available?
The API provides risk projections for baseline (current), 2030, 2040, 2050, and 2060. Request specific time horizons or receive all projections in the response.
Is the data aligned with TCFD requirements?
Yes. The Climate Risk API is designed for TCFD compliance, providing scenario analysis, physical risk categorization, and forward-looking projections required for TCFD disclosures.
What geographic resolution does the API use?
Hazard data is derived from multiple sources at varying resolutions, ranging from 1km to 25km depending on the hazard type. The API synthesizes these into a single assessment per coordinate.
Can I batch process multiple locations?
Yes. The /api/v1/climate-risk/batch/ endpoint accepts multiple coordinates in a single request. Contact us for enterprise batch limits and throughput requirements.
Related APIs
Geocoder API
Convert addresses to coordinates. Batch processing up to 5,000 locations.
LULC API
Land cover classification with EUDR compliance scoring via REST API.
Start Assessing Climate Risk Today
Get API access and integrate TCFD-aligned climate risk data into your workflows.

