API overview

Programmatically access Tracenable's corporate datasets with our REST API. Learn how to authenticate, search for companies, and retrieve verified data for specific reporting periods.

The Tracenable API provides programmatic access to our comprehensive corporate datasets. Built on REST principles, it enables you to integrate verified company data directly into your applications, research models, and internal workflows.

The Tracenable API is currently in Beta. Access is limited to Company (Search/List) and GHG Emissions endpoints. We are actively expanding the API and will release additional datasets and endpoints in the coming weeks. We welcome your feedback to help shape the product. Please send any comments, suggestions, or feature requests to [e-mail].

You can use the API to identify companies and retrieve their full datasets for specific reporting periods.

Base URL

All API requests should be made to the following base URL:

https://tracenable.com/api/v1

Authentication

The API uses Bearer Authentication. To access the API, you must include your API key in the Authorization header of each request.

To generate an API key, please visit the API key page.

Header Format:

Authorization: Bearer <YOUR_API_KEY>

Your API keys carry the same privileges as your user account. Keep them secure and never expose them in client-side code

Test Mode

You can explore the API and test your integration without consuming any credits by using our dedicated test token. Requests made with this token return mock data and are free of charge.

Authorization: Bearer sk_test_tracenable

Core Concepts

The API is designed around two primary actions: identifying companies and retrieving their data.

1. Company Identification: Use the Search or List endpoints to resolve a company's unique identifiers (such as company_id, ISIN, or LEI) using their name or ticker symbol.

2. Data Retrieval: Once you have identified a company, you can retrieve its full dataset for a specific reporting period (year). Unlike traditional APIs that might require fetching individual metrics, a single call to our endpoints retrieves all available data points for that company and year.

Response Codes & Data Availability

• 200 OK: The request was successful, and data was returned.

• 204 No Content: The company and reporting period exist, but the company did not publish any data for that specific year (e.g., they released a report but it did not contain the requested data).

• 404 Not Found: The company or reporting period could not be found, or the relevant documents have not yet been processed by our platform.

Pricing & Credits

The Tracenable API operates on a usage-based credit system.

• Pay-As-You-Go: You only pay for the data you successfully retrieve.

• Cached Data: Once you have purchased data for a specific company and year, subsequent requests for that same data (returning a 200 OK) are charged at a significantly reduced "cached" rate.

• No Expiration: Unused credits never expire.

You can monitor the cost of each call via the custom response headers included in every successful response:

• x-credit-cost: The cost of the specific request.

• x-credit-balance: Your account's current balance.

Each endpoint's documentation provides a breakdown of specific costs:

• Ghg Emissions – View pricing for absolute and intensity datasets.

• Company – View pricing for search and list operations.

To top up your balance, please visit the Billing Settings.