---
title: "Historical ESG Scores"
method: GET
path: "/stock/historical-esg"
tags: ["Default"]
---

# Historical ESG Scores

`GET /stock/historical-esg`

## Request

- Base URL: `https://finnhub.io/api/v1`
- URL: `https://finnhub.io/api/v1/stock/historical-esg`
- Auth: API key in query parameter `token`

This endpoint provides historical ESG scores and important indicators for 7000+ global companies. The data is collected through company's public ESG disclosure and public sources.

Our ESG scoring models takes into account more than 150 different inputs to calculate the level of ESG risks and how well a company is managing them. A higher score means lower ESG risk or better ESG management. ESG scores are in the the range of 0-100. Some key indicators might contain letter-grade score from C- to A+ with C- is the lowest score and A+ is the highest score.

## Query parameters

- `symbol` string, required

## Response `200`

successful operation

- HistoricalCompanyESG
  - `symbol` string: symbol
  - `data` CompanyESG2[]: Historical ESG data points.
    - `totalESGScore` number, float: Total ESG Score
    - `environmentScore` number, float: Environment Score
    - `governanceScore` number, float: Governance Score
    - `socialScore` number, float: Social Score
    - `data` object
    - `period` string: Period

## Changes

- **2024-11-05** `c6cbecbce416`: 1 breaking, 6 warning
  - the `data` response's property type changed from `object` to `array` for status `200`
  - removed the optional property `data/data` from the response with the `200` status
  - removed the optional property `data/environmentScore` from the response with the `200` status
  - removed the optional property `data/governanceScore` from the response with the `200` status
  - …3 more
- **2024-11-05** `fb7e94c545be`: 1 info
  - endpoint added
- **2020-05-26** `c5b8e420b78c`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/changes/stock/historical-esg/get.md)

---

[API](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api.md) - [All operations](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/finnhub-stock-api/apis/finnhub-api/revisions/415b27331384?raw)