Climate Risk Projections

Project future climate risks based on baseline emissions and projected future emissions for equity assets.

Endpoint

POST https://app.emmi.io/api/v1/climate-risk-projections

Authentication

Required. Include your API key in the X-API-Key header.

Overview

The climate risk projections endpoint calculates transition and physical climate risks for future years based on a baseline state and projected emissions. The API supports:

• Asset types: Equity only
• Multiple scenarios: Analyze risk under different climate futures (IPCC and NGFS)
• Multiple projection years: Assess risk for multiple future years
• Batch processing: Submit multiple entities in a single request

Requirements

• Baseline data: Single year with emissions and financials data
• Projected years: One or more future years with emissions data
• Scenarios: Climate scenarios to analyze against

Request Structure

Example Request

[
  {
    "entity_info": {
      "identifier": "ENRGY",
      "name": "Energy Corp",
      "asset_type": "equity",
      "country": "United States",
      "industry_classification_system": "factset",
      "industry": "Energy",
      "sector": "Oil & Gas"
    },
    "data": [
      {
        "year": 2023,
        "emissions": {
          "scope1": 500000,
          "scope2": 300000,
          "scope3": 1000000
        },
        "financials": {
          "revenue": 5000000000,
          "ebitda": 800000000
        }
      }
    ],
    "projections": [
      {
        "year": 2030,
        "emissions": {
          "scope1": 400000,
          "scope2": 250000,
          "scope3": 800000
        }
      },
      {
        "year": 2050,
        "emissions": {
          "scope1": 200000,
          "scope2": 150000,
          "scope3": 400000
        }
      }
    ],
    "scenarios": [
      "ipcc_net_zero",
      "ngfs_below_two_degree"
    ]
  }
]

Endpoint-Specific Fields

For data and projections field definitions, see Common Fields for Projection Endpoints.

scenarios (Required)

Array of climate scenario identifiers to analyze. Uses the same scenarios as the baseline climate risk endpoint.

Available Scenarios:

IPCC Scenarios: - ipcc_net_zero - IPCC Net Zero 2050 - ipcc_two_degree - IPCC 2°C Pathway - ipcc_four_degree - IPCC 4°C Pathway

NGFS Scenarios: - ngfs_net_zero - NGFS Net Zero 2050 - ngfs_below_two_degree - NGFS Below 2°C - ngfs_delayed_transition - NGFS Delayed Transition - ngfs_current_policies - NGFS Current Policies - ngfs_fragmented_world - NGFS Fragmented World - ngfs_low_demand - NGFS Low Demand - ngfs_ndc - NGFS NDC

Example:

"scenarios": ["ipcc_net_zero", "ngfs_below_two_degree"]

Response Format

Success Response (200 OK)

{
  "results": [
    {
      "entity_info": {
        "name": "Energy Corp",
        "asset_type": "equity",
        "country": "United States",
        "industry_classification_system": "factset",
        "industry": "Energy",
        "sector": "Oil & Gas"
      },
      "data": [
        {
          "year": 2030,
          "scenarios": [
            {
              "scenario": "ipcc_net_zero",
              "risk_metrics": [
                {
                  "analysis_year": "2030",
                  "metrics": {
                    "transition_var": 0.25,
                    "physical_var": 0.15,
                    "total_climate_var": 0.40
                  }
                }
              ]
            },
            {
              "scenario": "ngfs_below_two_degree",
              "risk_metrics": [
                {
                  "analysis_year": "2030",
                  "metrics": {
                    "transition_var": 0.18,
                    "physical_var": 0.20,
                    "total_climate_var": 0.38
                  }
                }
              ]
            }
          ]
        },
        {
          "year": 2050,
          "scenarios": [
            {
              "scenario": "ipcc_net_zero",
              "risk_metrics": [
                {
                  "analysis_year": "2050",
                  "metrics": {
                    "transition_var": 0.15,
                    "physical_var": 0.25,
                    "total_climate_var": 0.40
                  }
                }
              ]
            },
            {
              "scenario": "ngfs_below_two_degree",
              "risk_metrics": [
                {
                  "analysis_year": "2050",
                  "metrics": {
                    "transition_var": 0.12,
                    "physical_var": 0.30,
                    "total_climate_var": 0.42
                  }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Response Fields: - transition_var: Value-at-Risk from transition risks (carbon pricing, policy changes, technology shifts) - physical_var: Value-at-Risk from physical climate impacts (extreme weather, sea level rise) - total_climate_var: Combined Value-at-Risk from all climate-related risks - VaR metrics are expressed as decimals (0.25 = 25% risk)