Emissions

Estimate Scope 1, 2, and 3 greenhouse gas emissions for one or more assets based on financial data and optionally reported historical emissions.

Endpoint

POST https://app.emmi.io/api/v1/emissions-estimates

Authentication

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

Overview

The emissions estimate endpoint analyzes financial and operational data to estimate greenhouse gas emissions across all three scopes. The API supports:

• Multiple asset types: equity, debt, infrastructure, property
• Optional emissions: Provide reported emissions to improve estimates for other years
• Multi-year data: Submit 2-3 years of historical data
• Batch processing: Submit multiple entities in a single request

Request Structure

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

Basic Example

[
  {
    "entity_info": {
      "identifier": "TECH",
      "name": "TechCorp Inc",
      "asset_type": "equity",
      "country": "United States",
      "industry_classification_system": "rbics",
      "industry": "Technology",
      "sector": "Software & Services"
    },
    "data": [
      {
        "year": 2023,
        "emissions": {},
        "financials": {
          "currency": "USD",
          "revenue": 5000000,
          "total_assets": 5000000, 
          "ebitda": 5000000,
          "total_debt": 5000000
        }
      },
      {
        "year": 2022,
        "emissions": {
          "scope1": 20000,
          "scope2": 15000
        },
        "financials": {
          "currency": "USD",
          "revenue": 450000,
          "total_assets": 67000000, 
          "ebitda": 9000000,
          "total_debt": 500000
        }
        }
      }
    ]
  }
]

Endpoint-Specific Notes

Emission Fields by Asset Type

Equity

• scope1, scope2, scope3: Optional fields. Missing emissions will be estimated. When provided, reported emissions are used to improve estimates for other years.

Infrastructure & Property

• scope1, scope2: Optional fields. Missing emissions will be estimated. When provided, reported emissions are used to improve estimates for other years.
• scope3: Not applicable for infrastructure and property assets.

Debt

• underlying_scope1, underlying_scope2, underlying_scope3: When using reported emissions, you must provide the emissions of the underlying entity (the borrower), not the debt instrument itself.
• All three scopes should be provided for the underlying entity when available.

Data Array

• Multiple years recommended: 2-3 years of historical data improves accuracy
• Year gaps OK: API will estimate emissions for all years provided
• Financials required: Requirements vary by asset type. See Data Models for details.

Response Format

All responses are returned as JSON with appropriate HTTP status codes.

Success Response (200 OK)

{
  "results": [
    {
      "entity_info": {
        "name": "TechCorp Inc",
        "asset_type": "equity",
        "country": "United States",
        "industry_classification_system": "rbics",
        "industry": "Technology",
        "sector": "Software & Services"
      },
      "data": [
          {
            "year": "2023",
            "emissions": {
              "scope1": 25000,
              "scope1_pcaf": 3,
              "scope2": 20000,
              "scope2_pcaf": 3,
              "scope3": 100000,
              "scope3_pcaf": 4
            }
          },
          {
            "year": "2022",
            "emissions": {
              "scope1": 25000,
              "scope1_pcaf": 3,
              "scope2": 20000,
              "scope2_pcaf": 3,
              "scope3": 100000,
              "scope3_pcaf": 4
            }
          }
        ]
    }
  ]
}