Temperature Alignment

Calculate the implied temperature alignment of one or more assets based on their emissions and financial data.

Endpoint

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

Authentication

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

Overview

The temperature alignment endpoint assesses how an asset's emissions intensity aligns with global temperature goals (e.g., 1.5°C, 2°C). The API supports:

• Multiple asset types: equity, debt, infrastructure, property
• Simple requirements: Only emissions and financials data needed
• Batch processing: Submit multiple entities in a single request

Request Structure

See Data Models for complete documentation of entity_info, emissions, and financials fields.

Data Requirements

Important: Temperature alignment is calculated independently for each year of data provided. You can also specify future analysis years to assess temperature alignment at different points in time base on the current emissions and financials.

Basic Example

[
  {
    "entity_info": {
      "identifier": "ENRGY",
      "name": "Energy Corp",
      "asset_type": "equity",
      "country": "United States",
      "industry_classification_system": "rbics",
      "industry": "Energy",
      "sector": "Oil & Gas"
    },
    "data": [
      {
        "year": 2023,
        "emissions": {
          "scope1": 500000,
          "scope2": 300000,
          "scope3": 1000000
        },
        "financials": {
          "currency": "USD",
          "revenue": 5000000000,
          "ebitda": 800000000
        }
      }
    ]
  }
]

Multiple Years Example

To track temperature alignment over time, provide multiple years of data:

[
  {
    "entity_info": {
      "identifier": "ENRGY",
      "name": "Energy Corp",
      "asset_type": "equity",
      "country": "United States",
      "industry_classification_system": "rbics",
      "industry": "Energy",
      "sector": "Oil & Gas"
    },
    "data": [
      {
        "year": 2023,
        "emissions": {
          "scope1": 500000,
          "scope2": 300000,
          "scope3": 1000000
        },
        "financials": {
          "currency": "USD",
          "revenue": 5000000000,
          "ebitda": 800000000
        }
      },
      {
        "year": 2022,
        "emissions": {
          "scope1": 520000,
          "scope2": 310000,
          "scope3": 1050000
        },
        "financials": {
          "currency": "USD",
          "revenue": 4800000000,
          "ebitda": 750000000
        }
      }
    ]
  }
]

Analysis Years Example

Use analysis_years to assess temperature alignment for specific future years based on current emissions intensity:

[
  {
    "entity_info": {
      "identifier": "ENRGY",
      "name": "Energy Corp",
      "asset_type": "equity",
      "country": "United States",
      "industry_classification_system": "rbics",
      "industry": "Energy",
      "sector": "Oil & Gas"
    },
    "data": [
      {
        "year": 2023,
        "emissions": {
          "scope1": 500000,
          "scope2": 300000,
          "scope3": 1000000
        },
        "financials": {
          "currency": "USD",
          "revenue": 5000000000,
          "ebitda": 800000000
        }
      },
      {
        "year": 2024,
        "emissions": {
          "scope1": 490000,
          "scope2": 295000,
          "scope3": 980000
        },
        "financials": {
          "currency": "USD",
          "revenue": 5200000000,
          "ebitda": 820000000
        }
      }
    ],
    "analysis_years": [2030, 2050]
  }
]

How this works: - The 2023 data returns temperature alignment for: 2023, 2030, 2050 - The 2024 data returns temperature alignment for: 2024, 2030, 2050 - Each analysis uses that year's emissions intensity to calculate alignment at different future points

Response Format

Success Response (200 OK)

Basic Response (without analysis_years)

{
  "results": [
    {
      "entity_info": {
        "name": "Energy Corp",
        "asset_type": "equity",
        "country": "United States",
        "industry_classification_system": "rbics",
        "industry": "Energy",
        "sector": "Oil & Gas"
      },
      "data": [
        {
          "year": 2023,
          "temperature_alignment": 2.8
        },
        {
          "year": 2022,
          "temperature_alignment": 3.0
        }
      ]
    }
  ]
}

Response with analysis_years

When analysis_years are specified, each data year returns alignment for itself plus the requested future years:

{
  "results": [
    {
      "entity_info": {
        "name": "Energy Corp",
        "asset_type": "equity",
        "country": "United States",
        "industry_classification_system": "rbics",
        "industry": "Energy",
        "sector": "Oil & Gas"
      },
      "data": [
        {
          "year": 2023,
          "analysis_years": [
            {
              "analysis_year": 2023,
              "temperature_alignment": 2.8
            },
            {
              "analysis_year": 2030,
              "temperature_alignment": 2.8
            },
            {
              "analysis_year": 2050,
              "temperature_alignment": 2.8
            }
          ]
        },
        {
          "year": 2024,
          "analysis_years": [
            {
              "analysis_year": 2024,
              "temperature_alignment": 2.7
            },
            {
              "analysis_year": 2030,
              "temperature_alignment": 2.7
            },
            {
              "analysis_year": 2050,
              "temperature_alignment": 2.7
            }
          ]
        }
      ]
    }
  ]
}

Response Fields: - year: The data year for which calculations were based - analysis_year: The year being analyzed (data year or future year) - temperature_alignment: Implied temperature increase (°C) based on emissions intensity

Important notes: - The API automatically includes the data year itself in the analysis - Requesting analysis_years: [2030, 2050] for 2023 data returns: 2023, 2030, 2050 - Temperature alignment assumes current emissions intensity continues (use Temperature Alignment Projections for projected emissions pathways)