Changelog
Back to All

Version 3.50 June 2025

17 days ago

🥥

Highlights

The June 18 release introduces the following:

  • submit-spatial-areas-job and spatial-areas-get-job operations. This pair of endpoints retrieves financial impact results for a given spatial area.
  • additional stress testing endpoints for corporate data - shock-event-corporate-job and shock-event-corporate-get-job.

Learn More

Spatial Areas

submit-spatial-areas-job

Climate on Demand now supports the submit-spatial-areas-job operation. Use this new API endpoint to query data from our pre-processed database of climate change physical risk data measured across spatial areas. The endpoint produces financial impact data for different subsets of spatial areas defined by a geographic region and level of granularity, e.g. US counties.

To query the financial impact results for a given spatial area, specify the required parameters in the body of the request:

  • methodology_location
  • area_unit_name
  • rcp
  • th

For more tailored results, include these optional parameters:

  • methodology_area
  • data_snapshot_date
  • production_date

This endpoint returns a jobid, which is used by the spatial-areas-get-job operation to obtain the results. Climate on Demand returns the results files as a JSON file and a CSV file.

Example Request

Single rcp and th

{
    "job_type": "lookup-spatial-areas",
    "methodology_location": "P.2023.2",
    "methodology_area": "latest",
    "rcp": "rcp8.5",
    "th": "2050",
    "area_unit_name": "global_sovereign"
}

spatial-areas-get-job

Climate on Demand now supports the [spatial-areas-get-job](cod-v2-spatial-areas-get-job) operation. Use this new API endpoint to retrieve the results using the jobid.

Climate on Demand returns financial impact results including an impact score, an annualized damage rate (ADR), and the standard deviation for the annualized damage rate (ADR SD). A financial impact result is returned for each area unit, RCP, and time horizon combination.

📷

Hazard Results

At this time, hazard results are not part of this release of the lookup-spatial-area operation.

Example Response

Single rcp and th

{
    "job_id": "7175faa7-a014-431e-aff7-ad73ddf92c50"
}

GET: {{baseURL}}/cod/appsservices/api/v2/spatial-areas/jobs/{{job_id}}

{
    "status": "SUCCEEDED",
    "progress": 100,
    "start_date": "2025-02-20 20:52:24.05",
    "end_date": "2025-02-20 20:53:17.767",
    "download_url": "https://url.com"
}

Stress Testing for Corporates

This new API-only feature allows Climate on Demand Pro users to evaluate their Malaysia and Singapore assets against regulator-defined thematic climate shocks, specifically extreme flood events in Malaysia and Singapore. These APIs deliver damages for “shock events” pertaining to corporate assets. These shock events are designed to match hypothetical climate shock events defined by Banking regulators in various markets for the purposes of stress testing lending portfolios.

These new endpoints follow the same workflow as existing CoD Corporates endpoints.

📷

Shock Event Modeling

These new API endpoints are independent from Climate on Demand Pro global impact modeling and use simulated climate damages from Moody's RMS Southeast Asia Flood models. Documentation is available on Support Center separately from Climate on Demand Pro’s P.2023.2 methodology.

shock-event-corporate-job

The shock-event-corporate-job endpoint allows you to lookup damage data from a backend database by querying both the regulator and shock event description.

Each shock event API request is submitted as a JSON file and requires you specify a methodology_corporate, a data_snapshot_date, a production_date, a regulator, an event_description, and a set of companies. The companies are specified by the following paramters:

  • companies: orbis_id
  • companies: lei
  • companies: isin
  • companies: ticker

Climate on Demand returns a job_id.

Example Request

{  
  "job_type": "shock-event-corporates",  
  "methodology_corporate": "latest",  
  "data_snapshot_date": "2024-09-30",  
  "production_date": "latest",  
  "regulator": "MAS",  
  "event_description": "Flood RP200 RCP8.5 2050",  
  "companies": {  
    "orbis_id": [  
      "000411117",  
      "006529564",  
      "006530672",  
      "006531446",  
      "527018979"  
    ]  
  }  
}

shock-event-corporate-get-job

This endpoint retrieves the status of a specific job by its job_id. Once the job has succeeded you can download the scoring results files. Climate on Demand returns two files: a JSON and a CVS.

In addition to the fields in current Corporates APIs (status, progress, start_date, end_date, download_url), the JSON includes a new field, spatialResolutionType, indicating the spatial resolution used for mapping damage rates to locations.

The CSV output includes only facilities that are in the event footprint, with a separate row for each event.

Example JSON Response

{
  "status": "SUCCEEDED",
  "progress": 100,
  "start_date": "2024-xx-xxT21:30:30Z",
  "end_date": "2024-xx-xxT21:30:48Z",
  "spatialResolutionType": "admin3code",
  "download_url": "https://rms-tenants-..."
}