# Ghg Emissions
Greenhouse Gas Emissions data
## GHG Emissions (Absolute)
> Dataset covering corporate greenhouse gas emissions across Scopes 1, 2, and 3, reported in absolute terms (tCO2e), with detailed breakdowns by emission categories as per GHG Protocol.\
> \
> \
> Pricing (depending on the response received):\
> \- 200 (First access to the data): 50\
> \- 200 (Cached data): 1\
> \- 204 (Company did not publish data for the requested year): 1\
> \- Other responses (40x, 50x): Free of charge
````json
{"openapi":"3.0.0","info":{"title":"Tracenable API","version":"1.0.0"},"tags":[{"name":"ghg-emissions","description":"Greenhouse Gas Emissions data"}],"servers":[{"url":"https://tracenable.com","description":"Tracenable Production Server"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT bearer token used for authentication.\n\n**Test token (no charges apply; responses contain mock data):**\n```\nBearer sk_test_tracenable\n```"}}},"paths":{"/api/v1/ghg-emissions/absolute":{"get":{"summary":"GHG Emissions (Absolute)","description":"Dataset covering corporate greenhouse gas emissions across Scopes 1, 2, and 3, reported in absolute terms (tCO2e), with detailed breakdowns by emission categories as per GHG Protocol.\n\n\n Pricing (depending on the response received):\n- 200 (First access to the data): 50\n- 200 (Cached data): 1\n- 204 (Company did not publish data for the requested year): 1\n- Other responses (40x, 50x): Free of charge\n","operationId":"getGhgEmissionsAbsolute","tags":["ghg-emissions"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":15,"description":"The stock ticker of the company"},"required":false,"description":"The stock ticker of the company","name":"ticker","in":"query"},{"schema":{"type":"string","enum":["XAMM","XMLI","ALXP","XDUB","XNCO","XMAU","VPXB","FNLT","AQSG","XKUW","XWAR","XTRN","XAMS","XDHA","XZAG","XPRM","XKRX","NOTC","FSME","MTAA","XSHG","XSAU","XLUX","XBOG","SCLE","XSES","XJSE","XXXX","GROW","XNSE","OTCM","XTAI","BJSE","RUSX","XFRA","XHEL","MISX","XNCM","XEQY","XRIS","ZBUL","XDFM","HAMN","XMAI","XNSA","WBDM","XMAE","XBER","XLJM","XCAI","XBUE","XHKG","XNYS","MERK","AIXK","XOAS","ENAX","XADS","XLJU","XTKS","XBOM","XKLS","ARCX","XKAZ","XBRN","XPHS","XKAR","NSME","XSAT","XZIM","XTSE","XNMS","XBIL","XMUN","XIDX","BATS","XNGS","ALXB","ENXL","XSHE","XBAR","XNZE","XBSE","XLIS","XHAM","XLIT","AQST","XCSE","XSGO","XSTO","XNAI","XSTC","SSME","XCNQ","XLIM","DSME","XBKK","XCOL","XGUA","XMAL","DSMD","XASE","ROCO","XDUS","XBAH","HSTC","XBUD","FNIS","XSTU","XCYS","XMAD","XLON","XBRA","XKOS","EXGM","XCAN","XICE","XBRU","ABUL","XTAE","XTSX","XCAS","BVMF","XMEX","XSWX","XHNX","FNLV","XATH","XETR","XPRA","XPAR","HMOD","XNGM","XBEL","XOSL","XMUS","XTAL","XASX","WBAH","NEOE"],"description":"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."},"required":false,"description":"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.","name":"mic_code","in":"query"},{"schema":{"type":"string","format":"uuid","description":"The UUID of the company. If provided, this takes precedence over ticker and mic."},"required":false,"description":"The UUID of the company. If provided, this takes precedence over ticker and mic.","name":"company_id","in":"query"},{"schema":{"type":"string","minLength":12,"maxLength":12,"pattern":"^[A-Z]{2}[A-Z0-9]{9}[0-9]$","description":"The International Securities Identification Number (ISIN) of the company. If provided, this takes precedence over ticker and mic."},"required":false,"description":"The International Securities Identification Number (ISIN) of the company. If provided, this takes precedence over ticker and mic.","name":"isin","in":"query"},{"schema":{"type":"string","minLength":20,"maxLength":20,"pattern":"^[A-Z0-9]{18}[0-9]{2}$","description":"The Legal Entity Identifier (LEI) of the company. If provided, this takes precedence over ticker and mic."},"required":false,"description":"The Legal Entity Identifier (LEI) of the company. If provided, this takes precedence over ticker and mic.","name":"lei","in":"query"},{"schema":{"type":"integer","description":"The reporting period for which to retrieve GHG emissions. Accepts an absolute year (1990..2026) or a negative offset (-20..-1) where -1 resolves to the most recent reporting period available for the company, -2 to the second most recent, etc."},"required":true,"description":"The reporting period for which to retrieve GHG emissions. Accepts an absolute year (1990..2026) or a negative offset (-20..-1) where -1 resolves to the most recent reporting period available for the company, -2 to the second most recent, etc.","name":"reporting_period","in":"query"}],"responses":{"200":{"description":"Greenhouse Gas (GHG) Emissions - Absolute Values","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"year_of_disclosure":{"type":"integer","description":"Year in which the data point was disclosed."},"reporting_period":{"type":"integer","description":"Period for which the data point was measured, assessed, or is applicable."},"metric":{"type":"string","enum":["Total Scope 1","Total Scope 2","Total Scope 3","Categories of Scope 1","Categories of Scope 2","Categories of Scope 3","Total Scope 1 Revenue Intensity","Total Scope 2 Revenue Intensity","Total Scope 3 Revenue Intensity","Categories of Scope 1 Revenue Intensity","Categories of Scope 2 Revenue Intensity","Categories of Scope 3 Revenue Intensity"],"description":"The specific measurement or data points requested."},"level":{"type":"string","enum":["Total","Categories"],"description":"The level of emissions data, distinguishing between Total and Categories."},"type":{"type":"string","enum":["Absolute","Revenue Intensity"],"description":"The type of emissions data, indicating whether it is an intensity or absolute value."},"scope":{"type":"array","items":{"type":"string","enum":["Scope 1","Scope 2","Scope 3"]},"description":"GHG emission scopes (1, 2, and/or 3) included in the value."},"emissions_categories":{"type":"array","items":{"type":"string","enum":["Scope 1 - Direct GHG Releases","Scope 1 - Flaring","Scope 1 - Fugitive","Scope 1 - Mobile Combustion","Scope 1 - Other/Unspecified Sources","Scope 1 - Process","Scope 1 - Stationary Combustion","Scope 1 - Total","Scope 1 - Total Combustion","Scope 1 - Unspecified Combustion","Scope 1 - Venting","Scope 2 - Cooling","Scope 2 - Electricity","Scope 2 - Heat","Scope 2 - Other/Unspecified Sources","Scope 2 - Steam","Scope 2 - Total","Scope 3 - Business Travel (Cat. 6)","Scope 3 - Capital Goods (Cat. 2)","Scope 3 - Downstream Leased Assets (Cat. 13)","Scope 3 - Downstream Transportation and Distribution (Cat. 9)","Scope 3 - Employee Commuting (Cat. 7)","Scope 3 - End-of-Life Treatment of Sold Products (Cat. 12)","Scope 3 - Franchises (Cat. 14)","Scope 3 - Fuel- and Energy-Related Services (Cat. 3)","Scope 3 - Investments (Cat. 15)","Scope 3 - Other Downstream Sources","Scope 3 - Other Upstream Sources","Scope 3 - Other/Unspecified Sources","Scope 3 - Processing of Sold Products (Cat. 10)","Scope 3 - Purchased Goods and Services (Cat. 1)","Scope 3 - Total","Scope 3 - Total Downstream (Cat. 9+10+11+12+13+14+15)","Scope 3 - Total Transportation and Distribution","Scope 3 - Total Upstream (Cat. 1+2+3+4+5+6+7+8)","Scope 3 - Unspecified Transportation and Distribution","Scope 3 - Upstream Leased Assets (Cat. 8)","Scope 3 - Upstream Transportation and Distribution (Cat. 4)","Scope 3 - Use of Sold Products (Cat. 11)","Scope 3 - Waste Generated in Operations (Cat. 5)"]},"description":"Categories of GHG emissions."},"value":{"type":"number","description":"Amount of GHG emissions or intensity."},"unit":{"type":"string","enum":["Metric Tonnes of CO2 equivalent (mtCO2e)","Metric Tonnes of CO2 equivalent (mtCO2e) per million USD of revenue"],"description":"The unit of measurement for the value, indicating the scale or dimension."},"method":{"type":"string","enum":["Location-based","Market-based","Not Specified"],"description":"Approach used to calculate Scope 2 and occasionally Scope 3 GHG emissions, distinguishing between 'Location-Based' (reflecting grid averages), 'Market-Based' (reflecting the specific electricity profile purchased), and 'Not Specified' methods."},"incomplete_boundaries":{"type":"string","enum":["True"],"description":"Indicates whether the reported data covers only a limited portion of the company's operational or organizational boundaries."},"company_id":{"type":"string","format":"uuid","description":"Tracenable's internal company identifier."},"traceability_source_url":{"type":"string","format":"uri","description":"URL linking to the Tracenable platform, where each data point can be verified. Enables direct access to the audit trail for validation and transparency purposes."},"document_id":{"type":"string","format":"uuid","description":"Unique document identifier to see the source of the data point"}},"required":["year_of_disclosure","reporting_period","metric","level","type","scope","value","unit","company_id","traceability_source_url","document_id"]}}}}},"204":{"description":"No data available - the company did not publish data for the requested year.","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{}},"400":{"description":"Bad Request","content":{"text/plain":{"schema":{"type":"string"}}}},"401":{"description":"Unauthorized","content":{"text/plain":{"schema":{"type":"string"}}}},"402":{"description":"Insufficient credits","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{"text/plain":{"schema":{"type":"string"}}}},"403":{"description":"Subscription required","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{}},"404":{"description":"No data found for the provided parameters","content":{"text/plain":{"schema":{"type":"string"}}}},"500":{"description":"Internal Server Error","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}}
````
## GHG Emissions (Revenue Intensity)
> Dataset covering corporate greenhouse gas emissions across Scopes 1, 2, and 3, expressed as revenue-normalized intensity metrics (tCO2e per USD million), with detailed breakdowns by emission categories as per GHG Protocol.\
> \
> \
> Pricing (depending on the response received):\
> \- 200 (First access to the data): 50\
> \- 200 (Cached data): 1\
> \- 204 (Company did not publish data for the requested year): 1\
> \- Other responses (40x, 50x): Free of charge
````json
{"openapi":"3.0.0","info":{"title":"Tracenable API","version":"1.0.0"},"tags":[{"name":"ghg-emissions","description":"Greenhouse Gas Emissions data"}],"servers":[{"url":"https://tracenable.com","description":"Tracenable Production Server"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT bearer token used for authentication.\n\n**Test token (no charges apply; responses contain mock data):**\n```\nBearer sk_test_tracenable\n```"}}},"paths":{"/api/v1/ghg-emissions/intensity":{"get":{"summary":"GHG Emissions (Revenue Intensity)","description":"Dataset covering corporate greenhouse gas emissions across Scopes 1, 2, and 3, expressed as revenue-normalized intensity metrics (tCO2e per USD million), with detailed breakdowns by emission categories as per GHG Protocol.\n\n\n Pricing (depending on the response received):\n- 200 (First access to the data): 50\n- 200 (Cached data): 1\n- 204 (Company did not publish data for the requested year): 1\n- Other responses (40x, 50x): Free of charge\n","operationId":"getGhgEmissionsIntensity","tags":["ghg-emissions"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":15,"description":"The stock ticker of the company"},"required":false,"description":"The stock ticker of the company","name":"ticker","in":"query"},{"schema":{"type":"string","enum":["XAMM","XMLI","ALXP","XDUB","XNCO","XMAU","VPXB","FNLT","AQSG","XKUW","XWAR","XTRN","XAMS","XDHA","XZAG","XPRM","XKRX","NOTC","FSME","MTAA","XSHG","XSAU","XLUX","XBOG","SCLE","XSES","XJSE","XXXX","GROW","XNSE","OTCM","XTAI","BJSE","RUSX","XFRA","XHEL","MISX","XNCM","XEQY","XRIS","ZBUL","XDFM","HAMN","XMAI","XNSA","WBDM","XMAE","XBER","XLJM","XCAI","XBUE","XHKG","XNYS","MERK","AIXK","XOAS","ENAX","XADS","XLJU","XTKS","XBOM","XKLS","ARCX","XKAZ","XBRN","XPHS","XKAR","NSME","XSAT","XZIM","XTSE","XNMS","XBIL","XMUN","XIDX","BATS","XNGS","ALXB","ENXL","XSHE","XBAR","XNZE","XBSE","XLIS","XHAM","XLIT","AQST","XCSE","XSGO","XSTO","XNAI","XSTC","SSME","XCNQ","XLIM","DSME","XBKK","XCOL","XGUA","XMAL","DSMD","XASE","ROCO","XDUS","XBAH","HSTC","XBUD","FNIS","XSTU","XCYS","XMAD","XLON","XBRA","XKOS","EXGM","XCAN","XICE","XBRU","ABUL","XTAE","XTSX","XCAS","BVMF","XMEX","XSWX","XHNX","FNLV","XATH","XETR","XPRA","XPAR","HMOD","XNGM","XBEL","XOSL","XMUS","XTAL","XASX","WBAH","NEOE"],"description":"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."},"required":false,"description":"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.","name":"mic_code","in":"query"},{"schema":{"type":"string","format":"uuid","description":"The UUID of the company. If provided, this takes precedence over ticker and mic."},"required":false,"description":"The UUID of the company. If provided, this takes precedence over ticker and mic.","name":"company_id","in":"query"},{"schema":{"type":"string","minLength":12,"maxLength":12,"pattern":"^[A-Z]{2}[A-Z0-9]{9}[0-9]$","description":"The International Securities Identification Number (ISIN) of the company. If provided, this takes precedence over ticker and mic."},"required":false,"description":"The International Securities Identification Number (ISIN) of the company. If provided, this takes precedence over ticker and mic.","name":"isin","in":"query"},{"schema":{"type":"string","minLength":20,"maxLength":20,"pattern":"^[A-Z0-9]{18}[0-9]{2}$","description":"The Legal Entity Identifier (LEI) of the company. If provided, this takes precedence over ticker and mic."},"required":false,"description":"The Legal Entity Identifier (LEI) of the company. If provided, this takes precedence over ticker and mic.","name":"lei","in":"query"},{"schema":{"type":"integer","description":"The reporting period for which to retrieve GHG emissions. Accepts an absolute year (1990..2026) or a negative offset (-20..-1) where -1 resolves to the most recent reporting period available for the company, -2 to the second most recent, etc."},"required":true,"description":"The reporting period for which to retrieve GHG emissions. Accepts an absolute year (1990..2026) or a negative offset (-20..-1) where -1 resolves to the most recent reporting period available for the company, -2 to the second most recent, etc.","name":"reporting_period","in":"query"}],"responses":{"200":{"description":"Greenhouse Gas (GHG) Emissions - Intensity Values","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"year_of_disclosure":{"type":"integer","description":"Year in which the data point was disclosed."},"reporting_period":{"type":"integer","description":"Period for which the data point was measured, assessed, or is applicable."},"metric":{"type":"string","enum":["Total Scope 1","Total Scope 2","Total Scope 3","Categories of Scope 1","Categories of Scope 2","Categories of Scope 3","Total Scope 1 Revenue Intensity","Total Scope 2 Revenue Intensity","Total Scope 3 Revenue Intensity","Categories of Scope 1 Revenue Intensity","Categories of Scope 2 Revenue Intensity","Categories of Scope 3 Revenue Intensity"],"description":"The specific measurement or data points requested."},"level":{"type":"string","enum":["Total","Categories"],"description":"The level of emissions data, distinguishing between Total and Categories."},"type":{"type":"string","enum":["Absolute","Revenue Intensity"],"description":"The type of emissions data, indicating whether it is an intensity or absolute value."},"scope":{"type":"array","items":{"type":"string","enum":["Scope 1","Scope 2","Scope 3"]},"description":"GHG emission scopes (1, 2, and/or 3) included in the value."},"emissions_categories":{"type":"array","items":{"type":"string","enum":["Scope 1 - Direct GHG Releases","Scope 1 - Flaring","Scope 1 - Fugitive","Scope 1 - Mobile Combustion","Scope 1 - Other/Unspecified Sources","Scope 1 - Process","Scope 1 - Stationary Combustion","Scope 1 - Total","Scope 1 - Total Combustion","Scope 1 - Unspecified Combustion","Scope 1 - Venting","Scope 2 - Cooling","Scope 2 - Electricity","Scope 2 - Heat","Scope 2 - Other/Unspecified Sources","Scope 2 - Steam","Scope 2 - Total","Scope 3 - Business Travel (Cat. 6)","Scope 3 - Capital Goods (Cat. 2)","Scope 3 - Downstream Leased Assets (Cat. 13)","Scope 3 - Downstream Transportation and Distribution (Cat. 9)","Scope 3 - Employee Commuting (Cat. 7)","Scope 3 - End-of-Life Treatment of Sold Products (Cat. 12)","Scope 3 - Franchises (Cat. 14)","Scope 3 - Fuel- and Energy-Related Services (Cat. 3)","Scope 3 - Investments (Cat. 15)","Scope 3 - Other Downstream Sources","Scope 3 - Other Upstream Sources","Scope 3 - Other/Unspecified Sources","Scope 3 - Processing of Sold Products (Cat. 10)","Scope 3 - Purchased Goods and Services (Cat. 1)","Scope 3 - Total","Scope 3 - Total Downstream (Cat. 9+10+11+12+13+14+15)","Scope 3 - Total Transportation and Distribution","Scope 3 - Total Upstream (Cat. 1+2+3+4+5+6+7+8)","Scope 3 - Unspecified Transportation and Distribution","Scope 3 - Upstream Leased Assets (Cat. 8)","Scope 3 - Upstream Transportation and Distribution (Cat. 4)","Scope 3 - Use of Sold Products (Cat. 11)","Scope 3 - Waste Generated in Operations (Cat. 5)"]},"description":"Categories of GHG emissions."},"value":{"type":"number","description":"Amount of GHG emissions or intensity."},"unit":{"type":"string","enum":["Metric Tonnes of CO2 equivalent (mtCO2e)","Metric Tonnes of CO2 equivalent (mtCO2e) per million USD of revenue"],"description":"The unit of measurement for the value, indicating the scale or dimension."},"method":{"type":"string","enum":["Location-based","Market-based","Not Specified"],"description":"Approach used to calculate Scope 2 and occasionally Scope 3 GHG emissions, distinguishing between 'Location-Based' (reflecting grid averages), 'Market-Based' (reflecting the specific electricity profile purchased), and 'Not Specified' methods."},"incomplete_boundaries":{"type":"string","enum":["True"],"description":"Indicates whether the reported data covers only a limited portion of the company's operational or organizational boundaries."},"company_id":{"type":"string","format":"uuid","description":"Tracenable's internal company identifier."},"traceability_source_url":{"type":"string","format":"uri","description":"URL linking to the Tracenable platform, where each data point can be verified. Enables direct access to the audit trail for validation and transparency purposes."},"document_id":{"type":"string","format":"uuid","description":"Unique document identifier to see the source of the data point"}},"required":["year_of_disclosure","reporting_period","metric","level","type","scope","value","unit","company_id","traceability_source_url","document_id"]}}}}},"204":{"description":"No data available - the company did not publish data for the requested year.","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{}},"400":{"description":"Bad Request","content":{"text/plain":{"schema":{"type":"string"}}}},"401":{"description":"Unauthorized","content":{"text/plain":{"schema":{"type":"string"}}}},"402":{"description":"Insufficient credits","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{"text/plain":{"schema":{"type":"string"}}}},"403":{"description":"Subscription required - the user does not have an active subscription.","content":{}},"404":{"description":"No data found for the provided parameters","content":{"text/plain":{"schema":{"type":"string"}}}},"500":{"description":"Internal Server Error","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}}
````
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.tracenable.com/api/ghg-emissions.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.