Temperature Alignment Projections

Project future temperature alignment based on baseline emissions and projected future emissions.

Endpoint

POST https://app.emmi.io/api/v1/temperature-alignment-projections

Authentication

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

Overview

The temperature alignment projections endpoint calculates how future emissions trajectories align with global temperature goals (e.g., 1.5°C, 2°C). The API supports:

• Asset types: equity only
• Multiple projection years: Assess temperature alignment 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

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
        }
      }
    ],
    "projected_emissions": [
      {
        "year": 2030,
        "emissions": {
          "scope1": 400000,
          "scope2": 250000,
          "scope3": 800000
        }
      },
      {
        "year": 2050,
        "emissions": {
          "scope1": 200000,
          "scope2": 150000,
          "scope3": 400000
        }
      }
    ]
  }
]

Endpoint-Specific Fields

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

Note: The baseline data is used as a reference point; only future years are returned in the response.

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,
          "temperature_alignment": 2.3
        },
        {
          "year": 2050,
          "temperature_alignment": 1.8
        }
      ]
    }
  ]
}

Response Fields: - year: The projection year - temperature_alignment: Implied temperature increase (°C) based on projected emissions intensity

Notes: - Only future projection years are returned in the response - The baseline year is used for context but not included in results - Temperature alignment scores decrease (improve) as emissions reduction pathways align with climate goals