Skip to main content
GET
/
v1
/
stock
/
historical-esg
Get Historical ESG
curl --request GET \
  --url https://api.aries.com/v1/stock/historical-esg \
  --header 'Authorization: Bearer <token>'
{
  "symbol": "AAPL",
  "data": [
    {
      "totalESGScore": 70.26119,
      "environmentScore": 61.893806,
      "governanceScore": 87.10112,
      "socialScore": 61.788643,
      "data": {
        "adultContent": false,
        "alcoholic": false,
        "animalTesting": false,
        "antitrust": "14",
        "asianEmployeePercentage": 33.22,
        "asianManagementPercentage": 34.95,
        "blackEmployeePercentage": 8.1,
        "blackManagementPercentage": 3.4,
        "carbonReductionPolicy": "True",
        "catholic": true,
        "co2EmissionScope1": 55200,
        "co2EmissionScope2": 1224500,
        "co2EmissionScope3": 15070900,
        "co2EmissionTotal": 1279700,
        "coalEnergy": false,
        "ecofriendlyPackaging": true,
        "environmentalReporting": true,
        "firearms": false,
        "fuelEfficiencyConsumption": false,
        "gambling": false,
        "gmo": false,
        "hazardousSubstances": true,
        "hispanicLatinoEmployeePercentage": 14.27,
        "hispanicLatinoManagementPercentage": 7.55,
        "humanRightsPolicy": true,
        "militaryContract": false,
        "nuclear": false,
        "pesticides": null,
        "recallPolicySafety": false,
        "recyclingPolicy": true,
        "stakeholderEngagement": true,
        "tobacco": false,
        "totalWomenPercentage": 35,
        "waterEfficiencyConsumption": true,
        "whiteEmployeePercentage": 40.54,
        "whiteManagementPercentage": 51.31,
        "workplaceHealthSafety": true
      },
      "period": "2024-09-28"
    }
  ]
}

Query parameters

ParameterTypeRequiredDescription
symbolstringYesStock ticker symbol (e.g. AAPL).

Response

Success returns 200 OK with a JSON object typically containing a data array of historical ESG entries (e.g. period, environmentScore, governanceScore, socialScore, totalESGScore, and nested data fields), and symbol. Errors: 400 when symbol is missing, 401 unauthorized, 404 when no data found, 500 server error.

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

symbol
string
required

Stock ticker to query. Send the plain uppercase symbol exactly as you'd type it on a brokerage screen, e.g. AAPL, MSFT.

Example:

"AAPL"

Response

Historical ESG data.

data
object[]
symbol
string