This endpoint returns every company's response to SBTi, snapshotted once a week. Use the parameters to filter down the list.
Note the SBTi database has some inconsistencies. DitchCarbon has normalised the SBTi database to an extent, but there are still some problematic fields. As such, the parameters filters fields using a "contains" query. For example, providing isin=GB
searches for all SBTi companies that have GB
in their ISIN. Setting near_term_target_classification=Well-below 2
returns all SBTi companies that have set their near term target to "Well-below 2°C" but also those that set their near term targets to "Well-below 2°C/2°C".
The response is paginated. Increment the page
parameter to load more results.
Code Examples
curl -X GET "https://api.ditchcarbon.com/sbti_companies" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
# Query parameters:
# page:
# company_name:
# isin:
# lei:
# near_term_target_status:
# near_term_target_classification:
# near_term_target_year:
# long_term_target_status:
# long_term_target_classification:
# long_term_target_year:
# net_zero_committed:
# net_zero_year:
# organization_type:
# ba1_5:
# ba1_5_start:
# ba1_5_end:
# location:
# region:
# sector:
# date_start:
# date_end:
# target:
# target_classification:
# extension:
API Explorer
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
page | query | number | ❌ | |
company_name | query | string | ❌ | |
isin | query | string | ❌ | |
lei | query | string | ❌ | |
near_term_target_status | query | string | ❌ | |
near_term_target_classification | query | string | ❌ | |
near_term_target_year | query | string | ❌ | |
long_term_target_status | query | string | ❌ | |
long_term_target_classification | query | string | ❌ | |
long_term_target_year | query | string | ❌ | |
net_zero_committed | query | string | ❌ | |
net_zero_year | query | string | ❌ | |
organization_type | query | string | ❌ | |
ba1_5 | query | string | ❌ | |
ba1_5_start | query | string | ❌ | |
ba1_5_end | query | string | ❌ | |
location | query | string | ❌ | |
region | query | string | ❌ | |
sector | query | string | ❌ | |
date_start | query | string | ❌ | |
date_end | query | string | ❌ | |
target | query | string | ❌ | |
target_classification | query | string | ❌ | |
extension | query | string | ❌ |
Responses
200 Paginated list of SBTi companies matching query
Content type: application/json