---
title: "ESG Scores"
method: POST
path: "/v1/esg-performance-score/query"
tags: ["Company & Events"]
---

# ESG Scores

`POST /v1/esg-performance-score/query`

The ESG Performance Score API provides a comprehensive evaluation of a company's environmental, social, and governance (ESG) practices. It aggregates various ESG metrics into a single performance score, allowing investors and stakeholders to assess the company's commitment to sustainable and responsible business operations.

The ESG scores reflect companies' sustainability performance relative to financially material ESG issues. Scores are derived from standardized company-reported data and peer-based relative scoring techniques, resulting in a 0–100 scale that indicates a company's position versus its global peers, following a sector-specific, SASB (Sustainability Accounting Standards Board)-inspired materiality framework.

| Performance | Score Range |
|---|---|
| Laggard | < 42 |
| Below Average | 42 - 47 |
| Average | 48 - 53 |
| Above Average | 54 - 59 |
| Leader | ≥ 60 |

## Request body

- PublicGetPerformanceScoreQuery — Schema for the request to the public API. Only contains the identifier: - type: the identifier type (e.g., "rp_entity_id") - value: a single RP Entity ID or a list of IDs
  - `identifier` SingleIdentifier, required
    - `type` 'rp_entity_id', required
    - `value` string, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`)

## Response `200`

Successful Response

- PublicESGPerformanceScoreResponse
  - `results` union, required
    - ESGPerformanceScore
      - `rp_entity_id` string, required — The RavenPack entity ID of the company.
      - `name` string, required — The name of the company.
      - `ticker` string, required — The ticker symbol of the company.
      - `industry` string, nullable, required — The industry of the company.
      - `economic_sector` string, nullable, required — The economic sector of the company.
      - `esg_scores` string[], required — The fields of ESG performance scores.
      - `values` array[], required — The values of the ESG performance score.
        - union[]
          - union
            - string
            - integer
            - number
    - EmptyResponse

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.net/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/versions/18082de268c4/schema)