This article is for an API Partner integrating with the Disclosure API to update individual responses for disclosing organizations.
Summary
The Disclosure API enables participating API Partners to directly input responses to the CDP Response System, through an API, on behalf of their customers or tool users. API Partners currently use their own software tools to capture data and perform necessary calculations for organizations disclosing to CDP, the Disclosure API reduces the reporting burden for organizations responding to CDP and increases the quality and quantity of disclosure. The API works across all CDP questionnaires and authority types which are part of the 2025 disclosure cycle.
CDP’s Accredited Solutions Provider (ASP) program is designed for organizations who offer products, services, or expertise to help companies, cities, and governments meet their environmental goals. The program connects solutions providers with CDP’s global network of companies and entities committed to sustainability and transparency. CDP’s software ASPs support organizations with collecting and organizing their environmental data and reporting it through CDP. The Disclosure API will allow organizations disclosing through CDP to transfer data automatically from the provider’s own platform into CDP’s Portal. To learn more about becoming a software Accredited Solutions Provider or connecting to the Disclosure API in 2025, please contact partnerships@cdp.net.
You may also find the following articles helpful:
- Technical Overview
- API Endpoints:
API Definition
The Disclosure API allows API Partners to pull questionnaire and response data specific to a specified organization. This means that all returned data is subject to the onboarding steps and resulting tagging that is assigned to an organization, as such API Partners should integrate with the API to allow changes to the questionnaire/response structure to be captured when the user makes updates in the CDP Portal.
Below is a clear list of what the Disclosure API can be used for as part of the 2025 disclosure cycle, and also a summary of the current known limitations which should be considered before you sign up as an API Partner for this year.
Capabilities
- Retrieve questions: Fetch the list of all questions for the current year's questionnaires relevant to a given organization.
- Retrieve responses: Fetch responses to the questions for the current year's questionnaires relevant to a given organization.
- Enter responses and upload attachments: Enter responses to questions as well as uploading attachments.
- View conditional logic and calculations: View all conditional logic rules and calculations in a questionnaire (not specific to an organization).
- Manage matrix question rows: Add or remove user-created rows in matrix questions.
- Retrieve a list of organizations that have granted you access to their questionnaire & response data.
Limitations
- The Disclosure API has minimal data validation. Conditional logic (e.g., showing/hiding questions based on previous answers) must be managed by the API Partner’s software.
- You cannot view conditional logic specific for an individual organization’s questionnaire response, only general conditional logic rules.
- The full questionnaire response cannot be submitted via the Disclosure API and must be submitted in the CDP Portal. Access to past submission data is also not currently accessible via the Disclosure API.
- Only the English version of the questionnaire is available via the API.
- Retrieving the reporting guidance or scoring methodology guidance associated with a questionnaire is not currently available via the API (only help text is available).
- You cannot fetch data from specific questions or responses; the full questionnaire/response is always returned.
- You cannot remove already added file attachments from a question response via the API.
If you have not found the answer you were looking for, please contact your account manager who will be able to assist you further.