Company Ranking¶

Calculate the percentile ranking of a company within its industry and sector based on emissions intensity.

Endpoint¶

POST https://app.emmi.io/api/v1/company-ranking

Authentication¶

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

Overview¶

The company ranking endpoint benchmarks a company's carbon performance against the global universe of companies. It calculates percentiles for emissions intensity (Emissions / Revenue) across three metrics:

Scope 1 Intensity
Scope 1+2 Intensity
Scope 1+2+3 Intensity

Rankings are provided for both the company's Industry and Sector.

Request Structure¶

The request requires entity_info to identify the company's sector/industry and data containing financial (Revenue) and emissions data for one or more years.

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": {
          "scope1": 25000,
          "scope2": 20000,
          "scope3": 100000
        },
        "financials": {
          "currency": "USD",
          "revenue": 5000000
        }
      }
    ]
  }
]

Response Format¶

The response includes the calculated percentiles for each year provided.

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,
          "rankings": {
            "industry": {
              "scope1_intensity_percentile": 85.5,
              "scope1_2_intensity_percentile": 82.1,
              "scope1_2_3_intensity_percentile": 78.4
            },
            "sector": {
              "scope1_intensity_percentile": 88.2,
              "scope1_2_intensity_percentile": 84.5,
              "scope1_2_3_intensity_percentile": 80.1
            }
          }
        }
      ]
    }
  ]
}

Response Fields¶

Field	Description
`industry`	Percentile rankings within the specified Industry
`sector`	Percentile rankings within the specified Sector
`scope1_intensity_percentile`	Percentile for Scope 1 Emissions / Revenue
`scope1_2_intensity_percentile`	Percentile for (Scope 1 + Scope 2) Emissions / Revenue
`scope1_2_3_intensity_percentile`	Percentile for (Scope 1 + Scope 2 + Scope 3) Emissions / Revenue

Note: A higher percentile indicates higher emissions intensity relative to peers (i.e., worse carbon performance).