Refinitiv · Schema

Refinitiv ESG Score

Environmental, Social, and Governance score data for a company as provided by the Refinitiv Data Platform ESG API, including overall scores, pillar scores, and category-level measures.

Properties

Name	Type	Description
instrumentId	string	The instrument identifier (RIC or PermID) for the scored company.
companyName	stringnull	The company name associated with the ESG score.
periodEndDate	string	The fiscal period end date for the ESG assessment.
esgScore	numbernull	Overall ESG score combining all three pillars, ranging from 0 to 100.
esgCombinedScore	numbernull	Combined ESG score factoring in controversies, ranging from 0 to 100.
environmentPillarScore	numbernull	Environmental pillar score measuring resource use, emissions, and innovation, ranging from 0 to 100.
socialPillarScore	numbernull	Social pillar score measuring workforce, human rights, community, and product responsibility, ranging from 0 to 100.
governancePillarScore	numbernull	Governance pillar score measuring management, shareholders, and CSR strategy, ranging from 0 to 100.
esgGrade	stringnull	ESG grade on a letter scale from D- to A+.
controversiesScore	numbernull	Controversies score reflecting ESG-related negative news events, ranging from 0 to 100.
co2Emissions	numbernull	Total CO2 equivalent emissions in tonnes.
co2EmissionsScope1	numbernull	Direct CO2 emissions (Scope 1) in tonnes.
co2EmissionsScope2	numbernull	Indirect CO2 emissions from purchased energy (Scope 2) in tonnes.
industry	stringnull	The TRBC industry classification of the company.
country	stringnull	The country of domicile of the company.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.refinitiv.com/schemas/refinitiv/esg-score.json",
  "title": "Refinitiv ESG Score",
  "description": "Environmental, Social, and Governance score data for a company as provided by the Refinitiv Data Platform ESG API, including overall scores, pillar scores, and category-level measures.",
  "type": "object",
  "required": ["instrumentId", "periodEndDate"],
  "properties": {
    "instrumentId": {
      "type": "string",
      "description": "The instrument identifier (RIC or PermID) for the scored company."
    },
    "companyName": {
      "type": ["string", "null"],
      "description": "The company name associated with the ESG score."
    },
    "periodEndDate": {
      "type": "string",
      "format": "date",
      "description": "The fiscal period end date for the ESG assessment."
    },
    "esgScore": {
      "type": ["number", "null"],
      "description": "Overall ESG score combining all three pillars, ranging from 0 to 100.",
      "minimum": 0,
      "maximum": 100
    },
    "esgCombinedScore": {
      "type": ["number", "null"],
      "description": "Combined ESG score factoring in controversies, ranging from 0 to 100.",
      "minimum": 0,
      "maximum": 100
    },
    "environmentPillarScore": {
      "type": ["number", "null"],
      "description": "Environmental pillar score measuring resource use, emissions, and innovation, ranging from 0 to 100.",
      "minimum": 0,
      "maximum": 100
    },
    "socialPillarScore": {
      "type": ["number", "null"],
      "description": "Social pillar score measuring workforce, human rights, community, and product responsibility, ranging from 0 to 100.",
      "minimum": 0,
      "maximum": 100
    },
    "governancePillarScore": {
      "type": ["number", "null"],
      "description": "Governance pillar score measuring management, shareholders, and CSR strategy, ranging from 0 to 100.",
      "minimum": 0,
      "maximum": 100
    },
    "esgGrade": {
      "type": ["string", "null"],
      "description": "ESG grade on a letter scale from D- to A+.",
      "enum": ["A+", "A", "A-", "B+", "B", "B-", "C+", "C", "C-", "D+", "D", "D-", null]
    },
    "controversiesScore": {
      "type": ["number", "null"],
      "description": "Controversies score reflecting ESG-related negative news events, ranging from 0 to 100.",
      "minimum": 0,
      "maximum": 100
    },
    "co2Emissions": {
      "type": ["number", "null"],
      "description": "Total CO2 equivalent emissions in tonnes.",
      "minimum": 0
    },
    "co2EmissionsScope1": {
      "type": ["number", "null"],
      "description": "Direct CO2 emissions (Scope 1) in tonnes.",
      "minimum": 0
    },
    "co2EmissionsScope2": {
      "type": ["number", "null"],
      "description": "Indirect CO2 emissions from purchased energy (Scope 2) in tonnes.",
      "minimum": 0
    },
    "industry": {
      "type": ["string", "null"],
      "description": "The TRBC industry classification of the company."
    },
    "country": {
      "type": ["string", "null"],
      "description": "The country of domicile of the company."
    }
  },
  "$defs": {
    "CategoryScore": {
      "type": "object",
      "description": "An individual ESG category score within a pillar.",
      "properties": {
        "categoryName": {
          "type": "string",
          "description": "The category name such as Resource Use, Emissions, or Workforce."
        },
        "score": {
          "type": ["number", "null"],
          "description": "The category score ranging from 0 to 100.",
          "minimum": 0,
          "maximum": 100
        },
        "pillar": {
          "type": "string",
          "description": "The parent pillar for this category.",
          "enum": ["Environment", "Social", "Governance"]
        }
      }
    }
  }
}