Sustainability disclosure database

API Documentation

This API provides information about companies and their compliance with EU Taxonomy climate regulations. The database includes more than 2000 companies.

Use Cases

Analyze a company's impact on climate change.
Make predictions of future climate changes.
Train AI models with climate impact data.

Packages

Companies in the database are categorized into three packages: Public, Enterprise, and Financials.

Public Companies

Accessing data for public companies is free of charge.
Enterprise Package Companies

To access data for companies in the Enterprise package, users must apply and be accepted into the program. Once accepted, accessing data for each new enterprise company costs an additional 10 credits. This access remains free for the next 6 months after the initial request.
Financials Package Companies

Accessing data for companies in the Financials package requires individual negotiation for each client.

Authentication

The EU Taxonomy API requires authentication for all access. This ensures secure and controlled data access for all users. An access token must be provided to interact with the API.

Authenticated Access

To access the API's features and datasets, authentication is mandatory. You must use an access token, which can be passed either as a query parameter named token or in the HTTP header with the key X-Token.

Obtaining an Access Token

Register: Begin by registering for access to the API. Provide necessary information such as your organization details and intended use case.
Email Confirmation: After registration, confirm your email address by following the instructions sent to your inbox.
Receive Access Token: Once your email is confirmed, your access token will be available on your profile page. This token is unique to your account and must be kept secure.

Using the Access Token

Include the access token in your HTTP requests as follows:

As a query parameter: ?token=YOUR_ACCESS_TOKEN
Or as a header: X-Token: YOUR_ACCESS_TOKEN

Replace YOUR_ACCESS_TOKEN with the actual token you received upon email confirmation.

Token Security

It is crucial to keep your access token secure and confidential. Do not share it with unauthorized parties. If you suspect that your token has been compromised, please contact support immediately to revoke the token and obtain a new one.

Search Companies by Query (JSON)

GET https://sustainabilitydisclosures.com/api/v1/companysearch

Cost:
1 credit. Same request is free of charge for 6 months.

Query Params:

query required
The text to search for matching company names.
skip
Number of items to skip.
limit
Number of items to return, max 50.

Response:

companies: A list of company objects.

id: The id of the company
name: The name of the company.
lei: Legal Entity Identifier of the company
countryOfDomicile: The country where the company is domiciled.
fiscalYearEnd: The fiscal year-end date of the company.
industries: A list of industries associated with the company.

industry: Name of the industry.
supersector: Name of the supersector.
sector: Name of the sector.
subsector: Name of the subsector.

tickers: Stock tickers associated with the company.
isins: International Securities Identification Numbers for the company.
companyAvailability: Indicates the package the company belongs to (Public, EnterprisePackage, or FinancialsPackage).

totalCount: The total number of companies that match the query.

Examples:

https://sustainabilitydisclosures.com/api/v1/companysearch?query=vio&token=ede905ad-fac4-47a4-865b-165d4213fd46

curl -X GET "https://sustainabilitydisclosures.com/api/v1/companysearch?query=vio&token=ede905ad-fac4-47a4-865b-165d4213fd46" \
    -H "accept: application/json"

import requests

url = "https://sustainabilitydisclosures.com/api/v1/companysearch"
headers = {
    "accept": "application/json"
}
params = {
    "query" : "vio",
    "token" : "ede905ad-fac4-47a4-865b-165d4213fd46"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://sustainabilitydisclosures.com/api/v1/companysearch?query=vio&token=ede905ad-fac4-47a4-865b-165d4213fd46", {
    method: "GET",
    headers: {
        "Accept": "application/json"
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Example Response

{
  "companies": [
      {
          "id": "66a60fbf1a3204a0f1cbc2bb",
          "name": "Avio SpA",
          "lei": "8156008F25C4B0E7C860",
          "countryOfDomicile": "Italy",
          "fiscalYearEnd": "31 Dec",
          "industries": [
              {
                  "industry": "Industrials",
                  "supersector": "Capital Goods",
                  "sector": "Aerospace & Defense",
                  "subsector": "Aerospace & Defense"
              }
          ],
          "tickers": [
              "BIT: AVIO",
              "AVIO.MI"
          ],
          "isins": [
              "IT0005119810"
          ],
          "companyAvailability": "EnterprisePackage"
      },
    ]
}

Get EU Taxonomy Data (JSON)

GET https://sustainabilitydisclosures.com/api/v1/eutaxonomy/data/json

Cost:
Depends on amount of data in result. Same request if free of charge for 6 months, shread with XLSX endpoint.

Query Params:

taxonomy required
Type of taxonomy to return. Either Revenue, Capex or Opex
companyName required
Exact name of company to fetch data for

Response:

company: The name of the company for which the data is retrieved.
currency: The currency in which the values are expressed (e.g., EURm for millions of euros).
date: The date for which the data is applicable, usually representing the end of a fiscal year. Format is YYYY-MM-DD.
data: An object containing detailed EU Taxonomy data. Refer to the EU Taxonomy Regulation (Regulation (EU) 2020/852) for more information on the taxonomy structure and criteria.

taxonomyType: The type of taxonomy data. Possible values are: Revenue, Capex, Opex.
numericValues: An array of numeric values associated with the taxonomy type, each including:

valueType: The type of numeric value. Possible values are: AbsoluteValue, ProportionOfTotal, PreviousProportionOfTotal.
reportedValue: The actual numeric value reported.

categories: An array of objects, each representing a category of taxonomy data:

categoryType: The type of category. Possible values are: Aligned, EligibleButNotAligned, Eligible, NonEligible.
numericValues: An array of numeric values specific to this category, each including:

valueType: The type of numeric value. Possible values are: AbsoluteValue, ProportionOfTotal, PreviousProportionOfTotal.
reportedValue: The actual numeric value reported.

goalCompliances: An array of objects representing the company's compliance with specific goals:

goalType: The type of goal. Possible values are: Ccm, Cca, WaterAndMarineResources, Pollution, CircularEconomy, BiodiversityAndEcosystems, CcmDnsh, CcaDnsh, WaterAndMarineResourcesDnsh, PollutionDnsh, CircularEconomyDnsh, BiodiversityAndEcosystemsDnsh, MinimumSafeguards.
reportedGoalCompliance: Compliance status. Possible values are: Y, N, EL, N/EL.
reportedGoalProportion: The proportion of the goal that is reported as compliant.

activities: An array of objects detailing activities related to the category:

activityName: The name of the activity. List of possible names
numericValues: An array of numeric values related to the activity, each including:

valueType: The type of numeric value. Possible values are: AbsoluteValue, ProportionOfTotal, PreviousProportionOfTotal.
reportedValue: The actual numeric value reported.

goalCompliances: An array of objects representing compliance with specific goals for the activity:

goalType: The type of goal. Possible values are: Ccm, Cca, WaterAndMarineResources, Pollution, CircularEconomy, BiodiversityAndEcosystems, CcmDnsh, CcaDnsh, WaterAndMarineResourcesDnsh, PollutionDnsh, CircularEconomyDnsh, BiodiversityAndEcosystemsDnsh, MinimumSafeguards.
reportedGoalCompliance: Compliance status. Possible values are: Y, N, EL, N/EL.
reportedGoalProportion: The proportion of the goal that is reported as compliant.

categoryFlags: An array of flags indicating the nature of the category:

reportedCategoryFlag: Indicates whether the category is 'Enabling' or 'Transitional'. Possible values are: Enabling, Transitional.

Examples:

https://sustainabilitydisclosures.com/api/v1/eutaxonomy/data/json?companyName=Adidas&taxonomy=Capex&token=ede905ad-fac4-47a4-865b-165d4213fd46

References to EU Acts:

The EU taxonomy is part of the European Green Deal and is governed by the EU Taxonomy Regulation (Regulation (EU) 2020/852). This regulation establishes the criteria for determining whether an economic activity is environmentally sustainable. The taxonomy aims to provide transparency to investors and help companies transition to a low-carbon economy.

Notes:

Category Flags: These flags indicate whether an activity is considered enabling or transitional under the EU taxonomy, with links to the company's report for further details.

This structured response helps stakeholders understand a company's alignment with EU sustainability goals, providing a comprehensive view of its environmental impact and compliance.

curl -X GET "https://sustainabilitydisclosures.com/api/v1/eutaxonomy/data/json?companyName=Adidas&taxonomy=Capex&token=ede905ad-fac4-47a4-865b-165d4213fd46" \
    -H "accept: application/json"

import requests

url = "https://sustainabilitydisclosures.com/api/v1/eutaxonomy/data/json"
headers = {
    "accept": "application/json"
}
params = {
    "companyName" : "Adidas",
    "taxonomy" : "Capex",
    "token" : "ede905ad-fac4-47a4-865b-165d4213fd46"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://sustainabilitydisclosures.com/api/v1/eutaxonomy/data/json?companyName=Adidas&taxonomy=Capex&token=ede905ad-fac4-47a4-865b-165d4213fd46", {
    method: "GET",
    headers: {
        "Accept": "application/json"
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Example Responses

{
  "company": "Adidas",
  "currency": "EURm",
  "date": "2023-12-31",
  "data": {
    "taxonomyType": "Capex",
    "numericValues": [
      {
        "valueType": "AbsoluteValue",
        "reportedValue": 838
      },
      {
        "valueType": "ProportionOfTotal",
        "reportedValue": 100
      }
    ],
    "categories": [
      {
        "categoryType": "Aligned",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 7
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 1
          }
        ],
        "goalCompliances": [
          {
            "goalType": "Ccm",
            "reportedGoalProportion": 1
          },
          {
            "goalType": "Cca",
            "reportedGoalProportion": 0
          },
          {
            "goalType": "WaterAndMarineResources",
            "reportedGoalProportion": 0
          },
          {
            "goalType": "Pollution",
            "reportedGoalProportion": 0
          },
          {
            "goalType": "BiodiversityAndEcosystems",
            "reportedGoalProportion": 0
          },
          {
            "goalType": "CcmDnsh",
            "reportedGoalCompliance": "Y"
          },
          {
            "goalType": "CcaDnsh",
            "reportedGoalCompliance": "Y"
          },
          {
            "goalType": "WaterAndMarineResourcesDnsh",
            "reportedGoalCompliance": "Y"
          },
          {
            "goalType": "PollutionDnsh",
            "reportedGoalCompliance": "Y"
          },
          {
            "goalType": "BiodiversityAndEcosystemsDnsh",
            "reportedGoalCompliance": "Y"
          },
          {
            "goalType": "MinimumSafeguards",
            "reportedGoalCompliance": "Y"
          }
        ],
        "activities": [
          {
            "activityName": "6.5 = Transport by motorbikes, passenger cars and light commercial vehicles",
            "numericValues": [
              {
                "valueType": "AbsoluteValue",
                "reportedValue": 0
              },
              {
                "valueType": "ProportionOfTotal",
                "reportedValue": 0
              }
            ],
            "goalCompliances": [
              {
                "goalType": "Ccm",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "Cca",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "WaterAndMarineResources",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "Pollution",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "BiodiversityAndEcosystems",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "CcmDnsh",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "CcaDnsh",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "WaterAndMarineResourcesDnsh",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "PollutionDnsh",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "BiodiversityAndEcosystemsDnsh",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "MinimumSafeguards",
                "reportedGoalCompliance": "Y"
              }
            ],
            "categoryFlags": [
              {
                "reportedCategoryFlag": "Enabling"
              }
            ]
          },
          {
            "activityName": "7.3 = Installation, maintenance and repair of energy efficiency equipment",
            "numericValues": [
              {
                "valueType": "AbsoluteValue",
                "reportedValue": 0
              },
              {
                "valueType": "ProportionOfTotal",
                "reportedValue": 0
              }
            ],
            "goalCompliances": [
              {
                "goalType": "Ccm",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "Cca",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "WaterAndMarineResources",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "Pollution",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "BiodiversityAndEcosystems",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "CcmDnsh",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "CcaDnsh",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "WaterAndMarineResourcesDnsh",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "PollutionDnsh",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "BiodiversityAndEcosystemsDnsh",
                "reportedGoalCompliance": "N"
              },
              {
                "goalType": "MinimumSafeguards",
                "reportedGoalCompliance": "Y"
              }
            ],
            "categoryFlags": [
              {
                "reportedCategoryFlag": "Enabling"
              }
            ]
          },
          {
            "activityName": "7.7 = Acquisition and ownership of buildings",
            "numericValues": [
              {
                "valueType": "AbsoluteValue",
                "reportedValue": 7
              },
              {
                "valueType": "ProportionOfTotal",
                "reportedValue": 1
              }
            ],
            "goalCompliances": [
              {
                "goalType": "Ccm",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "Cca",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "WaterAndMarineResources",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "Pollution",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "BiodiversityAndEcosystems",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "CcmDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "CcaDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "WaterAndMarineResourcesDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "PollutionDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "BiodiversityAndEcosystemsDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "MinimumSafeguards",
                "reportedGoalCompliance": "Y"
              }
            ],
            "categoryFlags": [
              {
                "reportedCategoryFlag": "Enabling"
              }
            ]
          }
        ]
      },
      {
        "categoryType": "EligibleButNotAligned",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 337
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 40
          }
        ],
        "goalCompliances": [
          {
            "goalType": "Cca",
            "reportedGoalProportion": 0
          },
          {
            "goalType": "WaterAndMarineResources",
            "reportedGoalProportion": 0
          },
          {
            "goalType": "Pollution",
            "reportedGoalProportion": 0
          },
          {
            "goalType": "BiodiversityAndEcosystems",
            "reportedGoalProportion": 0
          }
        ],
        "activities": [
          {
            "activityName": "6.5 = Transport by motorbikes, passenger cars and light commercial vehicles",
            "numericValues": [
              {
                "valueType": "AbsoluteValue",
                "reportedValue": 16
              },
              {
                "valueType": "ProportionOfTotal",
                "reportedValue": 2
              }
            ],
            "goalCompliances": [
              {
                "goalType": "Ccm",
                "reportedGoalCompliance": "EL"
              },
              {
                "goalType": "Cca",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "WaterAndMarineResources",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "Pollution",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "BiodiversityAndEcosystems",
                "reportedGoalCompliance": "N/EL"
              }
            ]
          },
          {
            "activityName": "7.3 = Installation, maintenance and repair of energy efficiency equipment",
            "numericValues": [
              {
                "valueType": "AbsoluteValue",
                "reportedValue": 22
              },
              {
                "valueType": "ProportionOfTotal",
                "reportedValue": 3
              }
            ],
            "goalCompliances": [
              {
                "goalType": "Ccm",
                "reportedGoalCompliance": "EL"
              },
              {
                "goalType": "Cca",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "WaterAndMarineResources",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "Pollution",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "BiodiversityAndEcosystems",
                "reportedGoalCompliance": "N/EL"
              }
            ]
          },
          {
            "activityName": "7.7 = Acquisition and ownership of buildings",
            "numericValues": [
              {
                "valueType": "AbsoluteValue",
                "reportedValue": 299
              },
              {
                "valueType": "ProportionOfTotal",
                "reportedValue": 36
              }
            ],
            "goalCompliances": [
              {
                "goalType": "Ccm",
                "reportedGoalCompliance": "EL"
              },
              {
                "goalType": "Cca",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "WaterAndMarineResources",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "Pollution",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "BiodiversityAndEcosystems",
                "reportedGoalCompliance": "N/EL"
              }
            ]
          }
        ]
      },
      {
        "categoryType": "Eligible",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 344
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 41
          }
        ],
        "goalCompliances": [
          {
            "goalType": "Cca",
            "reportedGoalProportion": 0
          },
          {
            "goalType": "WaterAndMarineResources",
            "reportedGoalProportion": 0
          },
          {
            "goalType": "Pollution",
            "reportedGoalProportion": 0
          },
          {
            "goalType": "BiodiversityAndEcosystems",
            "reportedGoalProportion": 0
          }
        ]
      },
      {
        "categoryType": "NonEligible",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 494
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 59
          }
        ]
      }
    ]
  }
}

{
  "company": "Adidas",
  "currency": "EURm",
  "date": "2023-12-31",
  "data": {
    "taxonomyType": "Revenue",
    "numericValues": [
      {
        "valueType": "AbsoluteValue",
        "reportedValue": 21427
      },
      {
        "valueType": "ProportionOfTotal",
        "reportedValue": 100
      }
    ],
    "categories": [
      {
        "categoryType": "Aligned",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 0
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 0
          }
        ]
      },
      {
        "categoryType": "EligibleButNotAligned",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 0
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 0
          }
        ]
      },
      {
        "categoryType": "Eligible",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 0
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 0
          }
        ]
      },
      {
        "categoryType": "NonEligible",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 21427
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 100
          }
        ]
      }
    ]
  }
}

{
  "company": "AIXTRON",
  "currency": "EUR",
  "date": "2023-12-31",
  "data": {
    "taxonomyType": "Revenue",
    "numericValues": [
      {
        "valueType": "AbsoluteValue",
        "reportedValue": 629879926
      },
      {
        "valueType": "ProportionOfTotal",
        "reportedValue": 100
      }
    ],
    "categories": [
      {
        "categoryType": "Aligned",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 462476791
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 73.4
          },
          {
            "valueType": "PreviousProportionOfTotal",
            "reportedValue": 58.5
          }
        ],
        "goalCompliances": [
          {
            "goalType": "Ccm",
            "reportedGoalProportion": 73.4
          },
          {
            "goalType": "CcmDnsh",
            "reportedGoalCompliance": "Y"
          },
          {
            "goalType": "CcaDnsh",
            "reportedGoalCompliance": "Y"
          },
          {
            "goalType": "WaterAndMarineResourcesDnsh",
            "reportedGoalCompliance": "Y"
          },
          {
            "goalType": "PollutionDnsh",
            "reportedGoalCompliance": "Y"
          },
          {
            "goalType": "BiodiversityAndEcosystemsDnsh",
            "reportedGoalCompliance": "Y"
          },
          {
            "goalType": "MinimumSafeguards",
            "reportedGoalCompliance": "Y"
          }
        ],
        "activities": [
          {
            "activityName": "3.1 = Manufacture of renewable energy technologies",
            "numericValues": [
              {
                "valueType": "AbsoluteValue",
                "reportedValue": 12813967
              },
              {
                "valueType": "ProportionOfTotal",
                "reportedValue": 2
              },
              {
                "valueType": "PreviousProportionOfTotal",
                "reportedValue": 2
              }
            ],
            "goalCompliances": [
              {
                "goalType": "Ccm",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "Cca",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "WaterAndMarineResources",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "Pollution",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "BiodiversityAndEcosystems",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "CcmDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "CcaDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "WaterAndMarineResourcesDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "PollutionDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "BiodiversityAndEcosystemsDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "MinimumSafeguards",
                "reportedGoalCompliance": "Y"
              }
            ],
            "categoryFlags": [
              {
                "reportedCategoryFlag": "Enabling"
              }
            ]
          },
          {
            "activityName": "3.6 = Manufacture of other low carbon technologies",
            "numericValues": [
              {
                "valueType": "AbsoluteValue",
                "reportedValue": 449662824
              },
              {
                "valueType": "ProportionOfTotal",
                "reportedValue": 71.4
              },
              {
                "valueType": "PreviousProportionOfTotal",
                "reportedValue": 56.5
              }
            ],
            "goalCompliances": [
              {
                "goalType": "Ccm",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "Cca",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "WaterAndMarineResources",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "Pollution",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "BiodiversityAndEcosystems",
                "reportedGoalCompliance": "N/EL"
              },
              {
                "goalType": "CcmDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "CcaDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "WaterAndMarineResourcesDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "PollutionDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "BiodiversityAndEcosystemsDnsh",
                "reportedGoalCompliance": "Y"
              },
              {
                "goalType": "MinimumSafeguards",
                "reportedGoalCompliance": "Y"
              }
            ],
            "categoryFlags": [
              {
                "reportedCategoryFlag": "Enabling"
              }
            ]
          }
        ]
      },
      {
        "categoryType": "EligibleButNotAligned",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 0
          }
        ]
      },
      {
        "categoryType": "Eligible",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 462476791
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 73.4
          },
          {
            "valueType": "PreviousProportionOfTotal",
            "reportedValue": 58.5
          }
        ],
        "goalCompliances": [
          {
            "goalType": "Ccm",
            "reportedGoalProportion": 73.4
          }
        ]
      },
      {
        "categoryType": "NonEligible",
        "numericValues": [
          {
            "valueType": "AbsoluteValue",
            "reportedValue": 167403135
          },
          {
            "valueType": "ProportionOfTotal",
            "reportedValue": 26.6
          }
        ]
      }
    ]
  }
}

Get EU Taxonomy Data (XLSX)

GET https://sustainabilitydisclosures.com/api/v1/eutaxonomy/data/xlsx

Cost:
Depends on amount of data in result. Same request if free of charge for 6 months, shared with JSON endpoint.

Query Params:

taxonomy required
Type of taxonomy to return. Either Revenue, Capex or Opex
companyName required
Exact name of company to fetch data for
token
Token obtained after user confirmation. Note: Without authorization, the API will only return data for certain companies and will not include links.

Response:

An XLSX file containing the requested EU Taxonomy data.

Examples:

https://sustainabilitydisclosures.com/api/v1/eutaxonomy/data/xlsx?companyName=Adidas&taxonomy=Capex&token=ede905ad-fac4-47a4-865b-165d4213fd46

curl -X GET "https://sustainabilitydisclosures.com/api/v1/eutaxonomy/data/xlsx?companyName=Adidas&taxonomy=Capex&token=ede905ad-fac4-47a4-865b-165d4213fd46" \
    -H "accept: application/json"

import requests

url = "https://sustainabilitydisclosures.com/api/v1/eutaxonomy/data/xlsx"
headers = {
    "accept": "application/json"
}
params = {
    "companyName" : "Adidas",
    "taxonomy" : "Capex",
    "token" : "ede905ad-fac4-47a4-865b-165d4213fd46"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://sustainabilitydisclosures.com/api/v1/eutaxonomy/data/xlsx?companyName=Adidas&taxonomy=Capex&token=ede905ad-fac4-47a4-865b-165d4213fd46", {
    method: "GET",
    headers: {
        "Accept": "application/json"
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

List Companies (JSON)

GET https://sustainabilitydisclosures.com/api/v1/companieslist

Cost:
2000 credits. Same request is free of charge for 6 months.

Query Params:

skip
Number of items to skip.
limit
Number of items to return, max 50.

Response:

companies: A list of company objects.

id: The id of the company
name: The name of the company.
lei: Legal Entity Identifier of the company
countryOfDomicile: The country where the company is domiciled.
fiscalYearEnd: The fiscal year-end date of the company.
industries: A list of industries associated with the company.

industry: Name of the industry.
supersector: Name of the supersector.
sector: Name of the sector.
subsector: Name of the subsector.

tickers: Stock tickers associated with the company.
isins: International Securities Identification Numbers for the company.
companyAvailability: Indicates the package the company belongs to (Public, EnterprisePackage, or FinancialsPackage).

totalCount: The total number of companies that match the query.

curl -X GET "https://sustainabilitydisclosures.com/api/v1/companieslist?token=ede905ad-fac4-47a4-865b-165d4213fd46" \
    -H "accept: application/json"

import requests

url = "https://sustainabilitydisclosures.com/api/v1/companieslist"
headers = {
    "accept": "application/json"
}
params = {
    "token" : "ede905ad-fac4-47a4-865b-165d4213fd46"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

fetch("https://sustainabilitydisclosures.com/api/v1/companieslist?token=ede905ad-fac4-47a4-865b-165d4213fd46", {
    method: "GET",
    headers: {
        "Accept": "application/json"
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Example Response

{
  "companies": [
      {
          "id": "66a60fbf1a3204a0f1cbc2bb",
          "name": "Avio SpA",
          "lei": "8156008F25C4B0E7C860",
          "countryOfDomicile": "Italy",
          "fiscalYearEnd": "31 Dec",
          "industries": [
              {
                  "industry": "Industrials",
                  "supersector": "Capital Goods",
                  "sector": "Aerospace & Defense",
                  "subsector": "Aerospace & Defense"
              }
          ],
          "tickers": [
              "BIT: AVIO",
              "AVIO.MI"
          ],
          "isins": [
              "IT0005119810"
          ],
          "companyAvailability": "EnterprisePackage"
      },
    ]
}

API REFERENCE

API Documentation

Use Cases

Packages

Public Companies

Enterprise Package Companies

Financials Package Companies

Authentication

Authenticated Access

Obtaining an Access Token

Using the Access Token

Token Security

Search Companies by Query (JSON)

Example Response

Get EU Taxonomy Data (JSON)

Example Responses

Get EU Taxonomy Data (XLSX)

List Companies (JSON)

Example Response