Default

Historical ESG Scores

Changed on

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.

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

Query parameters

symbolstring required

Symbol.

Response

successful operation

symbolstring

symbol

Example response

{
  "symbol": "symbol",
  "data": [
    {
      "period": "period",
      "data": "{}",
      "totalESGScore": 0.8008282,
      "environmentScore": 6.0274563,
      "governanceScore": 1.4658129,
      "socialScore": 5.962134
    },
    {
      "period": "period",
      "data": "{}",
      "totalESGScore": 0.8008282,
      "environmentScore": 6.0274563,
      "governanceScore": 1.4658129,
      "socialScore": 5.962134
    }
  ]
}

Changes

  • c6cbecbce416Revision changes
    • breaking

      the response's property type changed from object to array for status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

  • fb7e94c545beRevision changes
    • info

      endpoint added