Company Climate Profile API

Give your customers a climate score on every company

One free API call returns the DitchCarbon Score, industry rank and climate commitments for any company your platform holds.

What the API returns

Your customers are asking for sustainability insight inside the tools they use every day, and building a climate dataset is not your product. The Company Climate Profile API is the light way to deliver on that demand. It answers three questions about any organisation in one response: who it is, how it scores, and what it has committed to. Give it a company name, website or identifier and the entity is resolved and profiled live, so a supplier or counterparty nobody has looked up before gets the same record as one that has been on the platform for years. DitchCarbon provides verified emissions data for over 2 million organisations, built on primary emissions data wherever it exists, so procurement, sustainability and finance teams can measure and act on supply chain and portfolio emissions from one source. The profile API carries the summary layer of that record into your product.

The API returns, for each organisation:
Identity and match.
The canonical organisation record: name, website, HQ region, industry, aliases and tickers, plus a link to its public DitchCarbon profile.
DitchCarbon Score.
A 0 to 100 score for the organisation's climate standing, with its percentile within its industry, its industry and regional rank, and the industry mean score for context.
Climate commitments, yes or no.
Fourteen flags. Thirteen initiatives: Science Based Targets initiative (committed or validated), CDP, The Climate Pledge, UN Global Compact Climate Champions, RE100, Climate Action 100+, Race to Zero, RSPO, PRI, Responsible Business Alliance, Responsible Minerals Initiative, Responsible Labor Initiative and EcoVadis. Plus one for whether at least one reduction action is on record.

Emissions figures, scope breakdowns, source documents, targets and history are not part of this API. They are available through the full DitchCarbon API, which is licensed separately and needs a platform account. The profile API is free under the terms below; the full API is billed on a different model.

What can your platform do with a company climate profile?

Answer the sustainability question without building the dataset

Every procurement, supplier management and finance platform is being asked the same thing by its customers: show me where this company stands on climate, here, in the record I am already looking at. A score and a set of commitment flags is the shape of answer that fits a supplier record, a counterparty view or a sourcing event. The profile API supplies it as a field, so your roadmap carries the feature and DitchCarbon carries the data.

Put a score in every record from day one

The API resolves any company your platform holds, on the name, website or identifier already in the record: DUNS, LEI, ISIN or S&P Global identifiers all work. There is no list to match against first and no onboarding project. Organisations already on file return at once; a company nobody has requested before is usually profiled within 24 hours, with its status updating as it is processed. The score and flags then move as organisations disclose, set targets and join initiatives, with no refresh cycle on your side.

Let customers act on it inside your workflows

A DitchCarbon Score and fourteen commitment flags are enough to sort, filter and trigger on. A low score with no commitments can raise a flag at onboarding, feed a scorecard weighting or route a supplier into an engagement workflow. The flags reach beyond carbon, too: RSPO, PRI and the three Responsible Business Alliance initiatives cover the sourcing, investment and labour commitments your customers are asked about in the same breath.

Send them deeper when they need it

Every score links to the organisation's public profile on ditchcarbon.com, where the full disclosure record sits: emissions by scope, targets, source documents. Your platform gives the headline; the profile gives the evidence behind it. A customer who wants the full record in their own systems can license the full DitchCarbon API, and the entity resolution is already done.

How do I get access?

REST API

Post the identifiers you hold for a company, and get the organisation's climate profile back as JSON. Any company can be requested: where a record already exists it is returned at once, and where it does not, the entity is resolved and profiled, usually within 24 hours, with the record's status updating as it is processed. The response is small by design, so it maps to a handful of fields on your supplier or counterparty object without transformation.

curl --request POST \ --url https://api.ditchcarbon.com/organizations \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '{ "name": "Apple, Inc.", "website": "https://apple.com", "hq_region": "US", "external_id": "your-record-id", "duns_number": "123456789", "lei_number": "5493001KJTIIGC8Y1R12", "isin_number": "US0378331005", "sp_global_number": "SPG123456" }'

The response carries the matched organisation, the DitchCarbon Score with its industry percentile, industry rank, regional rank and industry mean, and fourteen commitment flags. Identify an organisation by name, website, duns_number, lei_number, isin_number or sp_global_number, and pass your own external_id so the record maps straight back to yours. Where the request resolves to a subsidiary or a parent, organization_relationship_type says so, and matching_organization names the record the answer belongs to, so your customers never see a silent mismatch.

{ "id": 1286926, "name": "Apple, Inc.", "website": "https://apple.com", "external_id": "your-record-id", "hq_region": "US", "organization_relationship_type": "requested organization", "matching_organization": { "id": 209, "link": "https://ditchcarbon.com/organizations/apple", "name": "Apple, Inc.", "industry": { "id": 170, "name": "Computer and related services (72)" } }, "score": 0.96, "industry_score_percentile": 97, "rank": "very_high", "industry_rank": "very_low", "region_rank": "low", "industry": { "mean_score": 0.31 }, "initiatives": { "sbti": true, "cdp": true, "climate_pledge": false, "un_global_compact": false, "re100": true, "climate_action_100": false, "race_to_zero": false, "rspo": false, "pri": false, "responsible_business_alliance": true, "responsible_minerals_initiative": true, "responsible_labor_initiative": false, "ecovadis": true }, "reduction_action_present": true }
Authentication

Request an API key and authenticate with a standard Bearer token. One key covers the Company Climate Profile API and the free SBTi API, and the same key works across the rest of the DitchCarbon API if your customers go on to license it.

Request an API key
Tip: You can authenticate with an       Authorization: Bearer <token> header

What does free cover?

The Company Climate Profile API is free for many use cases, including embedding the score and commitment flags in a commercial software product for your customers to see and act on. Two conditions apply wherever the data is displayed.

Wherever a score or a commitment flag from this API appears in your product, the DitchCarbon logo appears with it. Logo files and placement guidance are available on request.

Each displayed score links to the organisation's public profile on ditchcarbon.com, using the matching organization.link field in the response. The profile is where your customer can see what the score rests on, so the attribution does a job for them as well as for us.

Bulk collection, resale or redistribution of the data as a dataset, and use inside a competing emissions data product, are outside the free terms and need a licence. Request volumes above the free allowance also move to a licensed plan.

Read the licence agreement

Which teams use this?

Procurement and spend management.

A climate score and commitment flags on every supplier record and in every sourcing event, so category managers see climate standing next to price and lead time when the decision is being made.

Read More

Supplier onboarding and third-party risk.

A score and fourteen flags at the point a supplier is onboarded or reviewed, with any company resolvable on request, so the sustainability check happens in the same flow as the financial and compliance checks.

Read More

Finance, treasury and portfolio systems.

A climate profile for every counterparty in a portfolio or ledger view, private companies included, as the first pass before the full emissions record is licensed for the lines that need it.

Read More

How do I start?

Four steps to your first call

  1. Request your free API key using the form below.
  2. Copy the Bearer token into your application or your API client.
  3. Post a company name, website or identifier (DUNS, LEI, ISIN or S&P Global) from one of your records to the organisations endpoint.
  4. Check the reference documentation for the full response fields, and the attribution guidance for the logo and profile link.
Tip: You can authenticate with an Authorization: Bearer <token> header.

Frequently asked questions

Get answers to the questions procurement and sustainability teams ask most often.

What is the DitchCarbon Score?
Can I embed this in a commercial product?
Does the Company Climate Profile API include emissions figures?
Which climate initiatives does the API report on?
How is this different from the free SBTi API?
How do I look up an organisation?
What if a customer of ours says their own score is wrong?

Get free access to the Company Climate Profile API

Request your API key and give your customers a climate score and commitment record on every company in your platform, resolved live from the records you already hold. Free for many use cases, with the DitchCarbon logo and a link to the profile shown wherever the data appears.

Request an API key