Ghg Emissions

Greenhouse Gas Emissions data

Beta

Absolute Greenhouse Gas (GHG) Emissions

get

Dataset covering corporate greenhouse gas emissions across Scopes 1, 2, and 3, with detailed breakdowns by emission categories. This endpoint provides absolute GHG emissions values.

Pricing (depending on the response received):

• 200 (First access to the data): $1.50

• 200 (Cached data): $0.01

• 204 (Company did not publish data for the requested year): $0.01

• Other responses (40x, 50x): Free of charge

Authorizations

BearerAuth

AuthorizationstringRequired

JWT bearer token used for authentication.

Test token (no charges apply; responses contain mock data):

Bearer sk_test_tracenable

Query parameters

tickerstring · min: 1 · max: 15Optional

The stock ticker of the company

Example: AAPL

mic_codestring · enumOptional

The Market Identifier Code (MIC) of the exchange where the company is listed (e.g., XNYS for New York Stock Exchange). If not provided, the first matching ticker will be used.

Example: XNYSPossible values:

company_idstring · uuidOptional

The UUID of the company. If provided, this takes precedence over ticker and mic.

Example: 550e8400-e29b-41d4-a716-446655440000

isinstring · min: 12 · max: 12Optional

The International Securities Identification Number (ISIN) of the company. If provided, this takes precedence over ticker and mic.

Example: US0378331005Pattern: ^[A-Z]{2}[A-Z0-9]{9}[0-9]$

leistring · min: 20 · max: 20Optional

The Legal Entity Identifier (LEI) of the company. If provided, this takes precedence over ticker and mic.

Example: 5493001KJTIIGC8Y1R12Pattern: ^[A-Z0-9]{18}[0-9]{2}$

reporting_periodinteger · min: 1990 · max: 2026Required

The reporting period for which to retrieve GHG emissions.

Example: 2020

Responses

200

Greenhouse Gas (GHG) Emissions - Absolute Values

application/json

204

No data available - the company did not publish data for the requested year.

400

Bad Request

text/plain

401

Unauthorized

text/plain

402

Insufficient credits

text/plain

404

No data found for the provided parameters

text/plain

500

Internal Server Error

text/plain

get

/api/v1/ghg-emissions/absolute

HTTPcURLJavaScriptPython

GET /api/v1/ghg-emissions/absolute?reporting_period=2020 HTTP/1.1
Host: tracenable.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "year_of_disclosure": 2023,
    "reporting_period": 2023,
    "metric": "Categories of Scope 2",
    "level": "Total",
    "type": "Absolute",
    "scope": [
      "Scope 1"
    ],
    "emissions_categories": [
      "Scope 2 - Cooling",
      "Scope 2 - Electricity",
      "Scope 2 - Heat",
      "Scope 2 - Steam"
    ],
    "value": 12000000,
    "unit": "Metric Tonnes of CO2 equivalent (mtCO2e)",
    "method": "Market-based",
    "company_id": "dfb6bd7b-facf-4d0f-86a2-f1eedf191946",
    "traceability_source_url": "https://tracenable.com/source-trace?data-request-id-hash=AF-CkCtAvJnG&project=ghg-emissions",
    "document_id": "c4cab302-dcc2-49ef-a2f9-895f14b70928"
  }
]

Beta

Intensity Greenhouse Gas (GHG) Emissions

get

Dataset covering corporate greenhouse gas emissions across Scopes 1, 2, and 3, with detailed breakdowns by emission categories.. This endpoint provides GHG emissions revenue intensity values.

Pricing (depending on the response received):

• 200 (First access to the data): $1.50

• 200 (Cached data): $0.01

• 204 (Company did not publish data for the requested year): $0.01

• Other responses (40x, 50x): Free of charge

Authorizations

BearerAuth

AuthorizationstringRequired

JWT bearer token used for authentication.

Test token (no charges apply; responses contain mock data):

Bearer sk_test_tracenable

Query parameters

tickerstring · min: 1 · max: 15Optional

The stock ticker of the company

Example: AAPL

mic_codestring · enumOptional

The Market Identifier Code (MIC) of the exchange where the company is listed (e.g., XNYS for New York Stock Exchange). If not provided, the first matching ticker will be used.

Example: XNYSPossible values:

company_idstring · uuidOptional

The UUID of the company. If provided, this takes precedence over ticker and mic.

Example: 550e8400-e29b-41d4-a716-446655440000

isinstring · min: 12 · max: 12Optional

The International Securities Identification Number (ISIN) of the company. If provided, this takes precedence over ticker and mic.

Example: US0378331005Pattern: ^[A-Z]{2}[A-Z0-9]{9}[0-9]$

leistring · min: 20 · max: 20Optional

The Legal Entity Identifier (LEI) of the company. If provided, this takes precedence over ticker and mic.

Example: 5493001KJTIIGC8Y1R12Pattern: ^[A-Z0-9]{18}[0-9]{2}$

reporting_periodinteger · min: 1990 · max: 2026Required

The reporting period for which to retrieve GHG emissions.

Example: 2020

Responses

200

Greenhouse Gas (GHG) Emissions - Intensity Values

application/json

204

No data available - the company did not publish data for the requested year.

400

Bad Request

text/plain

401

Unauthorized

text/plain

402

Insufficient credits

text/plain

404

No data found for the provided parameters

text/plain

500

Internal Server Error

text/plain

get

/api/v1/ghg-emissions/intensity

HTTPcURLJavaScriptPython

GET /api/v1/ghg-emissions/intensity?reporting_period=2020 HTTP/1.1
Host: tracenable.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "year_of_disclosure": 2023,
    "reporting_period": 2023,
    "metric": "Categories of Scope 2",
    "level": "Total",
    "type": "Absolute",
    "scope": [
      "Scope 1"
    ],
    "emissions_categories": [
      "Scope 2 - Cooling",
      "Scope 2 - Electricity",
      "Scope 2 - Heat",
      "Scope 2 - Steam"
    ],
    "value": 12000000,
    "unit": "Metric Tonnes of CO2 equivalent (mtCO2e)",
    "method": "Market-based",
    "company_id": "dfb6bd7b-facf-4d0f-86a2-f1eedf191946",
    "traceability_source_url": "https://tracenable.com/source-trace?data-request-id-hash=AF-CkCtAvJnG&project=ghg-emissions",
    "document_id": "c4cab302-dcc2-49ef-a2f9-895f14b70928"
  }
]