Skip to content

Meet us at COP31Read more

Bring the report collection
into your workflow.

How the API works

API access comes with an Enterprise Licence. This page covers what your developers need to know.

Query the catalogue, retrieve report metadata as JSON, and request original PDFs through short-lived download links. Filter by company, framework, year, language, country, and sector.

Cursor pagination supports larger collections. Incremental queries and content hashes help your team retrieve new or changed records and avoid duplicates.

API access follows your Enterprise Licence scope. We agree entity coverage, reporting periods, report access, and any Markdown or ESG data requirements before setup.

Agree the scope. Get connected.

Tell us what you cover

Share the entities, reporting periods, report types, and data products your team needs.

Agree your annual licence

Confirm the deliverables, coverage, service requirements, and annual price together.

Onboard with our team

Set up access and delivery, connect your systems where needed, and work with our team throughout the licence year.

Discuss your requirementsBrowse data products

TECHNICAL REFERENCE

For your development team.

Metadata: 50 fields per report

Report metadata includes company identifiers, report types, reporting years, languages, frameworks, and assurance.

View the metadata field guide
Authentication, environments, and API endpoints

Authentication & environments

Send your API key with every request:

Authorization: Bearer YOUR_API_KEY

Keys are issued per client, with defined scopes and rate limits. All requests use TLS and a single base URL:

https://api.sustainabilityreports.com/api/v2

Read the API documentation and download the OpenAPI 3.1 specification to generate client code.

API documentation

Core endpoints

GET /reports
Filter and browse reports
GET /reports/{id}
Read report metadata
GET /reports/{id}/download
Request a PDF download URL
POST /companies/resolve
Match company identifiers
GET /entitlements
Check your access scope
GET /meta/usage
Review request and download activity
Download the Data API brochure

FAQ

When do I need an Enterprise Licence?

When your team needs reports for a fixed list of companies throughout the year, not just a one-off download. We keep that collection updated every week for as long as the licence runs.

What is included, and how do we get started?

All report types for the companies in your licence, updated weekly, as original PDFs with 50-field metadata. Alerts, API access, onboarding and priority support are included, and we put extra sourcing effort into your companies so new reports show up quickly.

To get started, send us your company list and we’ll set everything up with you.

What can the API do, and where are the technical details?

Your systems can search companies and reports, pull metadata and download the original PDFs, all within your licence. The technical details are on the API access page.

How are the licence scope and annual price agreed?

The annual fee is based on the number of companies in your licence. Before setup, your quote confirms the years, coverage, how you’ll access the data and any extra data work.