The Didomi platform offers a standard REST API that you can use to manage all aspects of the platform. Its base URL is:
Our API uses standard HTTP verbs (
POST, etc.) to retrieve or modify resources and standard HTTP error codes (
5xx) to communicate errors when they happen with detailed error information in the body. All standard HTTP clients are able to talk to our API without modifications. The API always responds in JSON, including for errors. The only exception are routes that also support different formats like reports. In that case, JSON is the default format unless otherwise specified and additional response formats can be specified in the request.
This section will guide you through setting up an API client and using the main resources exposed by our API. You will also want to consult our complete API specification (https://api.didomi.io/docs/) as a reference when using our API.
You will need an API key and secret to call our API. You can create private API keys directly in the Didomi Console.
You can use most of our API as part of our CMP or Preference Center products. The Consents API and the Integrations are priced separately and are not included in your CMP or Preference Center contracts.
- Introduction: Setup your environment for using the Didomi API and learn about standard topics like authentication, errors, pagination, filters, and quotas.
- Widgets: Create, configure and publish widgets to collect consent, preferences and privacy requests