# OneTrust Developer Portal Documentation ## Guides - [Data Discovery Connector SDK](https://developer.onetrust.com/onetrust/docs/adding-sdk-to-app.md) - [Command queue for embedded web forms](https://developer.onetrust.com/onetrust/docs/command-queue.md) - [Common SDK Methods (External web form)](https://developer.onetrust.com/onetrust/docs/common-sdk-methods.md) - [Embedded web forms methods and events](https://developer.onetrust.com/onetrust/docs/embedded-web-forms-methods-and-events.md) - [Web Form Collection Point JavaScript SDK](https://developer.onetrust.com/onetrust/docs/getting-started-1.md) - [Sample JavaScript SDK and Instructions](https://developer.onetrust.com/onetrust/docs/sample-javascript-sdk-and-instructions.md) - [Trigger Collection Points](https://developer.onetrust.com/onetrust/docs/trigger-collection-points.md) - [Cross Domain and Cross Device Consent](https://developer.onetrust.com/onetrust/docs/cross-domain-cross-device.md) - [Managing Known Users](https://developer.onetrust.com/onetrust/docs/managing-known-users.md): Understand how to configure your OneTrust CMP and Universal Consent & Preference Management tools when your audience is identified - [Unified Profile](https://developer.onetrust.com/onetrust/docs/unified-profile.md): Learn how to save a user's CMP preferences onto their Universal Consent profile. - [IAB TC String Encoder](https://developer.onetrust.com/onetrust/docs/tc-string-encoder.md) - [OneTrust SDK Reference](https://developer.onetrust.com/onetrust/docs/onetrust-sdk-reference.md) - [Mobile & OTT/CTV SDKs](https://developer.onetrust.com/onetrust/docs/mobile-ctv.md) - [Scanning and Categorizing SDKs](https://developer.onetrust.com/onetrust/docs/app-scanning.md) - [How App Scanner Works](https://developer.onetrust.com/onetrust/docs/how-app-scanner-works.md) - [Publish Changes](https://developer.onetrust.com/onetrust/docs/publish-changes.md) - [Scan Apps via API](https://developer.onetrust.com/onetrust/docs/scan-apps-via-api.md) - [OneTrust Hands-On Lab](https://developer.onetrust.com/onetrust/docs/taking-a-onetrust-hands-on-lab.md) - [POST /classifications/v1](https://developer.onetrust.com/onetrust/docs/ai-guard-api-classify.md) - [GET /health](https://developer.onetrust.com/onetrust/docs/ai-guard-api-health.md) - [POST /metric](https://developer.onetrust.com/onetrust/docs/ai-guard-api-metric.md) - [API Overview](https://developer.onetrust.com/onetrust/docs/ai-guard-api-overview.md) - [Authentication & Authorization](https://developer.onetrust.com/onetrust/docs/ai-guard-authentication.md) - [Classification Profiles](https://developer.onetrust.com/onetrust/docs/ai-guard-classification-profiles.md) - [Service Configuration](https://developer.onetrust.com/onetrust/docs/ai-guard-service-configuration.md) - [TLS & Certificate Pinning](https://developer.onetrust.com/onetrust/docs/ai-guard-tls-certificate-pinning.md) - [Docker Deployment](https://developer.onetrust.com/onetrust/docs/ai-guard-docker.md) - [Kubernetes Deployment](https://developer.onetrust.com/onetrust/docs/ai-guard-kubernetes.md) - [Networking Requirements](https://developer.onetrust.com/onetrust/docs/ai-guard-networking.md) - [Error Reference](https://developer.onetrust.com/onetrust/docs/ai-guard-error-reference.md) - [FAQ](https://developer.onetrust.com/onetrust/docs/ai-guard-faq.md) - [Create an API Key](https://developer.onetrust.com/onetrust/docs/ai-guard-create-api-key.md) - [Deploy the Light Worker Node](https://developer.onetrust.com/onetrust/docs/ai-guard-deploy-worker-node.md) - [Install the SDK](https://developer.onetrust.com/onetrust/docs/ai-guard-install-sdk.md) - [Prerequisites](https://developer.onetrust.com/onetrust/docs/ai-guard-prerequisites.md) - [Metrics Exporters](https://developer.onetrust.com/onetrust/docs/ai-guard-exporters.md) - [Meter Definitions](https://developer.onetrust.com/onetrust/docs/ai-guard-meters.md) - [Metrics Overview](https://developer.onetrust.com/onetrust/docs/ai-guard-metrics-overview.md) - [Classify Text](https://developer.onetrust.com/onetrust/docs/ai-guard-classification.md) - [Classifier Descriptions](https://developer.onetrust.com/onetrust/docs/ai-guard-classifier-descriptions.md) - [Initializing the Client](https://developer.onetrust.com/onetrust/docs/ai-guard-initializing-the-client.md) - [Observability & Metrics](https://developer.onetrust.com/onetrust/docs/ai-guard-metrics.md) - [Redact Sensitive Data](https://developer.onetrust.com/onetrust/docs/ai-guard-redaction.md) - [Streaming Classification](https://developer.onetrust.com/onetrust/docs/ai-guard-streaming.md) - [Troubleshooting](https://developer.onetrust.com/onetrust/docs/ai-guard-troubleshooting.md) - [AI Guard](https://developer.onetrust.com/onetrust/docs/ai-guard.md) - [API Reference](https://developer.onetrust.com/onetrust/docs/api-reference-android-legacy.md) - [CNIL Continue Without Accepting](https://developer.onetrust.com/onetrust/docs/cnil-continue-without-accepting-android-legacy.md) - [Google Advertising ID](https://developer.onetrust.com/onetrust/docs/google-advertising-id-android-legacy.md) - [Google Consent Mode](https://developer.onetrust.com/onetrust/docs/google-consent-mode-android-legacy.md) - [IAB CCPA US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string-android-legacy.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-global-privacy-platform-legacy.md) - [IAB TCF 2.2](https://developer.onetrust.com/onetrust/docs/iab-tcf-22-android-legacy.md) - [Multi Profile Consent](https://developer.onetrust.com/onetrust/docs/multi-profile-consent-legacy.md) - [Passing Consent to WebView](https://developer.onetrust.com/onetrust/docs/pass-consent-to-webview-android-legacy.md) - [Proxying SDK Network Calls](https://developer.onetrust.com/onetrust/docs/proxying-sdk-network-calls-android-legacy.md) - [SDK Logging](https://developer.onetrust.com/onetrust/docs/sdk-logging-android-legacy.md) - [Universal Consent Purposes](https://developer.onetrust.com/onetrust/docs/universal-consent-purposes-android-legacy.md) - [Changelog](https://developer.onetrust.com/onetrust/docs/changelog-android-legacy.md) - [Adding SDK to App](https://developer.onetrust.com/onetrust/docs/adding-sdk-to-app-android-legacy.md) - [Customize User Interfaces](https://developer.onetrust.com/onetrust/docs/customize-user-interfaces-android-legacy.md) - [Display User Interfaces](https://developer.onetrust.com/onetrust/docs/display-user-interfaces-android-legacy.md) - [Download and Import SDK](https://developer.onetrust.com/onetrust/docs/download-the-sdk-android-legacy.md) - [Initialize SDK](https://developer.onetrust.com/onetrust/docs/initialize-the-sdk-android-legacy.md) - [Sample App](https://developer.onetrust.com/onetrust/docs/sample-app-android-legacy.md) - [When Consent Changes](https://developer.onetrust.com/onetrust/docs/when-consent-changes-android-legacy.md) - [Android SDK (Legacy)](https://developer.onetrust.com/onetrust/docs/android-legacy.md) - [API Reference](https://developer.onetrust.com/onetrust/docs/api-reference-android-next-gen.md) - [CNIL Continue Without Accepting](https://developer.onetrust.com/onetrust/docs/cnil-continue-without-accepting-android-next-gen.md) - [Google Advertising ID](https://developer.onetrust.com/onetrust/docs/google-advertising-id-android-next-gen.md) - [Google Consent Mode](https://developer.onetrust.com/onetrust/docs/google-consent-mode-android-next-gen.md) - [IAB CCPA US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string-android-next-gen.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-global-privacy-protocol-android-next-gen.md) - [IAB Transparency and Consent Framework (TCF)](https://developer.onetrust.com/onetrust/docs/iab-tcf-android-next-gen.md) - [Multi Profile Consent](https://developer.onetrust.com/onetrust/docs/multi-profile-consent-android-next-gen.md) - [Passing Consent to WebView](https://developer.onetrust.com/onetrust/docs/passing-consent-to-webview-android-next-gen.md) - [Proxy SDK Network Calls](https://developer.onetrust.com/onetrust/docs/proxy-sdk-network-calls-android-next-gen.md) - [SDK Logging](https://developer.onetrust.com/onetrust/docs/sdk-logging-android-next-gen.md) - [Universal Consent Purposes](https://developer.onetrust.com/onetrust/docs/universal-consent-purposes-android-next-gen.md) - [CMP Configuration Data](https://developer.onetrust.com/onetrust/docs/android-legacy-deprecated-methods-cmp-configuration-data.md) - [Legacy to Next Gen SDK Deprecated Methods](https://developer.onetrust.com/onetrust/docs/android-legacy-to-next-gen-sdk-deprecated-methods.md) - [Customize User Interfaces](https://developer.onetrust.com/onetrust/docs/customize-user-interfaces-android-next-gen.md) - [Display User Interfaces](https://developer.onetrust.com/onetrust/docs/display-user-interfaces-android-next-gen.md) - [Download and Import the SDK](https://developer.onetrust.com/onetrust/docs/download-and-import-sdk-to-app-android-next-gen.md) - [Initialize the SDK](https://developer.onetrust.com/onetrust/docs/initialize-sdk-android-next-gen.md) - [Sample App](https://developer.onetrust.com/onetrust/docs/sample-app-android-next-gen.md) - [When Consent Changes](https://developer.onetrust.com/onetrust/docs/when-consent-changes-android-next-gen.md) - [Android SDK](https://developer.onetrust.com/onetrust/docs/android-sdk-next-gen.md) - [Cordova / Ionic](https://developer.onetrust.com/onetrust/docs/cordova-ionic.md): The OneTrust Cordova/Ionic library is hosted on [NPM](https://www.npmjs.com/package/cordova-plugin-onetrust-cmp). - [Flutter](https://developer.onetrust.com/onetrust/docs/flutter.md): The OneTrust Flutter library is hosted on [pub.dev](https://pub.dev/packages/onetrust_publishers_native_cmp). - [Frameworks](https://developer.onetrust.com/onetrust/docs/frameworks.md) - [React Native](https://developer.onetrust.com/onetrust/docs/react-native.md): The OneTrust React Native library is hosted on [NPM](https://www.npmjs.com/package/react-native-onetrust-cmp). - [API Reference](https://developer.onetrust.com/onetrust/docs/api-reference-ios-tvos-legacy.md): OneTrust iOS SDK Public Methods - [App Tracking Transparency](https://developer.onetrust.com/onetrust/docs/app-tracking-transparency-ios-tvos-legacy.md) - [CNIL Continue Without Accepting](https://developer.onetrust.com/onetrust/docs/cnil-continue-without-accepting-ios-tvos-legacy.md) - [Google Consent Mode](https://developer.onetrust.com/onetrust/docs/google-consent-mode-ios-legacy.md) - [IAB CCPA US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string-ios-tvos-legacy.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-global-privacy-platform-1-legacy.md) - [IAB TCF 2.2](https://developer.onetrust.com/onetrust/docs/iab-tcf-22-ios-tvos-legacy.md) - [Multi Profile Consent](https://developer.onetrust.com/onetrust/docs/multi-profile-consent-ios-legacy.md) - [Passing Consent to WebView](https://developer.onetrust.com/onetrust/docs/passing-consent-to-webview-ios-tvos-legacy.md) - [Proxying SDK Network Calls](https://developer.onetrust.com/onetrust/docs/proxying-sdk-network-calls-ios-legacy.md) - [SDK Logging](https://developer.onetrust.com/onetrust/docs/sdk-logging-ios-tvos-legacy.md) - [Universal Consent Purposes](https://developer.onetrust.com/onetrust/docs/universal-consent-purposes-legacy.md) - [Changelog](https://developer.onetrust.com/onetrust/docs/changelog-ios-tvos-legacy.md) - [Add SDK to App](https://developer.onetrust.com/onetrust/docs/add-sdk-to-app-ios-tvos-legacy.md) - [Customize User Interfaces](https://developer.onetrust.com/onetrust/docs/customize-user-interfaces-ios-tvos-legacy.md) - [Display User Interfaces](https://developer.onetrust.com/onetrust/docs/display-user-interfaces-ios-tvos-legacy.md) - [Download the SDK](https://developer.onetrust.com/onetrust/docs/download-the-sdk-ios-tvos-legacy.md) - [Initialize SDK](https://developer.onetrust.com/onetrust/docs/initialize-the-sdk-ios-tvos-legacy.md) - [Sample App](https://developer.onetrust.com/onetrust/docs/sample-app-ios-tvos-legacy.md) - [When Consent Changes](https://developer.onetrust.com/onetrust/docs/when-consent-changes-ios-legacy.md) - [iOS & tvOS SDK (Legacy)](https://developer.onetrust.com/onetrust/docs/ios-tvos-legacy.md) - [App Tracking Transparency](https://developer.onetrust.com/onetrust/docs/app-tracking-transparency-ios-next-gen.md) - [Customize User Interfaces (Optional)](https://developer.onetrust.com/onetrust/docs/customize-user-interfaces-ios-next-gen.md) - [Google Consent Mode](https://developer.onetrust.com/onetrust/docs/google-consent-mode-ios-next-gen.md) - [IAB CCPA US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string-ios-next-gen.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-global-privacy-protocol-ios-next-gen.md) - [IAB Transparency and Consent Framework (TCF)](https://developer.onetrust.com/onetrust/docs/iab-tcf-22-ios-next-gen.md) - [Multi Profile Consent](https://developer.onetrust.com/onetrust/docs/multi-profile-consent-ios-next-gen.md) - [Passing Consent to WebView](https://developer.onetrust.com/onetrust/docs/passing-consent-to-webview-ios-next-gen.md) - [Proxying SDK Network Calls](https://developer.onetrust.com/onetrust/docs/proxying-sdk-network-calls-ios-next-gen.md) - [SDK Logging](https://developer.onetrust.com/onetrust/docs/sdk-logging-ios-next-gen.md) - [Universal Consent Purposes](https://developer.onetrust.com/onetrust/docs/universal-consent-purposes-ios-next-gen.md) - [Additional Information](https://developer.onetrust.com/onetrust/docs/additional-information.md): Additional information on OneTrust iOS SDK public methods - [Groups (Categories/Purposes) Helpers](https://developer.onetrust.com/onetrust/docs/groups-categoriespurposes.md): OneTrust SDK Public Methods for Groups (Categories/Purposes) - [Multi-Profile](https://developer.onetrust.com/onetrust/docs/multi-profile.md): OneTrust SDK Public Methods for Multi Profile Consent - [OneTrust SDK Additional Helpers](https://developer.onetrust.com/onetrust/docs/onetrust-sdk-additional-helpers.md): OneTrust SDK Public Methods for Saving Consent and Additional use-cases - [OneTrust SDK Helpers](https://developer.onetrust.com/onetrust/docs/onetrust-sdk-helpers.md): OneTrust iOS SDK Public Methods for Initial SDK Setup - [OneTrust UI Helpers](https://developer.onetrust.com/onetrust/docs/onetrust-ui-helpers.md): OneTrust SDK Public Methods for Showing the User Interfaces - [Prompts](https://developer.onetrust.com/onetrust/docs/prompts-att-and-age-gate.md): OneTrust SDK Public Methods for Apple Tracking Transparency(ATT) and Age Gate Prompts - [Proxy](https://developer.onetrust.com/onetrust/docs/proxy.md): OneTrust SDK Public Methods for setting up Proxy configuration for OneTrust network calls - [SDK List Helpers](https://developer.onetrust.com/onetrust/docs/sdk-list.md): OneTrust SDK Public Methods for First Party SDKs - [Universal Consent Purposes Helpers](https://developer.onetrust.com/onetrust/docs/universal-consent-purposes-ucp-helpers.md): OneTrust SDK Public Methods for Universal Consent Purposes (UCP) - [Vendors Helpers](https://developer.onetrust.com/onetrust/docs/vendors-helpers.md): OneTrust SDK Public Methods for IAB and Google Vendors - [Display User Interfaces](https://developer.onetrust.com/onetrust/docs/display-user-interfaces-ios-next-gen.md) - [Download and Import the SDK](https://developer.onetrust.com/onetrust/docs/download-the-sdk-ios-next-gen.md) - [Initialize the SDK](https://developer.onetrust.com/onetrust/docs/initialize-sdk-next-gen.md) - [Sample App](https://developer.onetrust.com/onetrust/docs/sample-app-ios-tvos-next-gen.md) - [When Consent Changes](https://developer.onetrust.com/onetrust/docs/when-consent-changes-ios-next-gen.md) - [iOS & tvOS SDK](https://developer.onetrust.com/onetrust/docs/ios-tvos-sdk-next-gen.md) - [Legacy to Next Gen SDK Deprecated Methods](https://developer.onetrust.com/onetrust/docs/ios-legacy-to-next-gen-sdk-deprecated-methods.md) - [CMP Configuration Data](https://developer.onetrust.com/onetrust/docs/ios-legacy-deprecated-methods-cmp-configuration-data.md) - [General Vendors and IAB Data](https://developer.onetrust.com/onetrust/docs/ios-legacy-deprecated-methods-general-vendors-and-iab-data.md) - [Proxy](https://developer.onetrust.com/onetrust/docs/ios-legacy-deprecated-methods-proxy.md) - [Universal Consent Data](https://developer.onetrust.com/onetrust/docs/ios-legacy-deprecated-methods-universal-consent-data.md) - [API Reference](https://developer.onetrust.com/onetrust/docs/api-reference-maui-new.md) - [IAB CCPA US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string-maui-new.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-global-privacy-protocol-maui-new.md) - [IAB Transparency and Consent Framework (TCF)](https://developer.onetrust.com/onetrust/docs/iab-tcf-22-maui-new.md) - [Add SDK to App](https://developer.onetrust.com/onetrust/docs/add-sdk-to-app-maui-new.md) - [Customize User Interfaces](https://developer.onetrust.com/onetrust/docs/customize-user-interfaces-maui-new.md) - [Display User Interfaces](https://developer.onetrust.com/onetrust/docs/display-user-interfaces-maui-new.md) - [Download the SDK](https://developer.onetrust.com/onetrust/docs/download-the-sdk-maui-new.md) - [Initialize the SDK](https://developer.onetrust.com/onetrust/docs/initialize-the-sdk-maui-new.md) - [When Consent Changes](https://developer.onetrust.com/onetrust/docs/when-consent-changes-maui-new.md) - [MAUI and Unity SDK](https://developer.onetrust.com/onetrust/docs/maui-and-unity-sdk-new.md) - [API Reference](https://developer.onetrust.com/onetrust/docs/api-reference-maui-legacy.md) - [IAB CCPA US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string-maui-legacy.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-global-privacy-platform-maui-legacy.md) - [IAB TCF 2.2](https://developer.onetrust.com/onetrust/docs/iab-tcf-22-maui-legacy.md) - [Changelog](https://developer.onetrust.com/onetrust/docs/changelog-xamarin-unity.md) - [Add SDK to App](https://developer.onetrust.com/onetrust/docs/add-sdk-to-app-maui-legacy.md) - [Customize User Interfaces](https://developer.onetrust.com/onetrust/docs/customize-user-interfaces-maui-legacy.md) - [Display User Interfaces](https://developer.onetrust.com/onetrust/docs/display-user-interfaces-maui-legacy.md) - [Download the SDK](https://developer.onetrust.com/onetrust/docs/download-the-sdk-maui-legacy.md) - [Initialize the SDK](https://developer.onetrust.com/onetrust/docs/initialize-the-sdk-maui-legacy.md) - [When Consent Changes](https://developer.onetrust.com/onetrust/docs/when-consent-changes-maui-legacy.md) - [MAUI and Unity SDK (Legacy)](https://developer.onetrust.com/onetrust/docs/maui-legacy.md) - [OneTrust Next Generation CMP SDKs](https://developer.onetrust.com/onetrust/docs/onetrusts-next-generation-cmp-sdks.md) - [Release Notes](https://developer.onetrust.com/onetrust/docs/release-notes.md) - [Cross Device and Domain Consent - Roku](https://developer.onetrust.com/onetrust/docs/cross-device-consent-legacy.md) - [IAB CCPA US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string-roku-legacy.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-global-privacy-platform-2-legacy.md) - [IAB TCF 2.2](https://developer.onetrust.com/onetrust/docs/iab-tcf-22-1-legacy.md) - [Changelog](https://developer.onetrust.com/onetrust/docs/changelog-roku.md) - [Add SDK to App](https://developer.onetrust.com/onetrust/docs/add-sdk-to-app-roku-legacy.md) - [Display User Interfaces](https://developer.onetrust.com/onetrust/docs/display-user-interfaces-roku-legacy.md) - [Download the SDK](https://developer.onetrust.com/onetrust/docs/download-sdk-roku-legacy.md) - [Initialize the SDK](https://developer.onetrust.com/onetrust/docs/initialize-the-sdk-roku-legacy.md) - [When Consent Changes](https://developer.onetrust.com/onetrust/docs/when-consent-changes-roku-legacy.md) - [Roku SDK (Legacy)](https://developer.onetrust.com/onetrust/docs/roku-legacy.md) - [API Reference](https://developer.onetrust.com/onetrust/docs/api-reference-roku-next-gen.md) - [Cross Device and Cross Domain Consent](https://developer.onetrust.com/onetrust/docs/cross-device-consent-roku-next-gen.md) - [IAB CCPA US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string-roku-next-gen.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-global-privacy-protocol-roku-next-gen.md) - [IAB Transparency and Consent Framework (TCF)](https://developer.onetrust.com/onetrust/docs/iab-tcf-22-roku-next-gen.md) - [Multi Profile Consent](https://developer.onetrust.com/onetrust/docs/multi-profile-consent-roku-next-gen.md) - [Display User Interfaces](https://developer.onetrust.com/onetrust/docs/display-user-interfaces-roku-next-gen.md) - [Download and Import the SDK](https://developer.onetrust.com/onetrust/docs/download-the-sdk-roku-next-gen.md) - [Initialize the SDK](https://developer.onetrust.com/onetrust/docs/initialize-the-sdk-roku-next-gen.md) - [When Consent Changes](https://developer.onetrust.com/onetrust/docs/when-consent-changes-roku-next-gen.md) - [Roku SDK](https://developer.onetrust.com/onetrust/docs/roku-new.md) - [API Reference](https://developer.onetrust.com/onetrust/docs/api-reference.md) - [IAB CCPA US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string-1.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-global-privacy-platform-4.md) - [IAB TCF 2.2](https://developer.onetrust.com/onetrust/docs/iab-tcf-22.md) - [SDK Logging](https://developer.onetrust.com/onetrust/docs/sdk-logging.md) - [Configure SDK Parameters](https://developer.onetrust.com/onetrust/docs/configure-sdk-parameters.md) - [Display User Interfaces](https://developer.onetrust.com/onetrust/docs/display-user-interfaces.md) - [Download SDK](https://developer.onetrust.com/onetrust/docs/download-sdk.md) - [When Consent Changes](https://developer.onetrust.com/onetrust/docs/when-consent-changes.md) - [HTML5 SDK - Tizen and WebOS (Legacy)](https://developer.onetrust.com/onetrust/docs/tizen-and-webos-sdk-legacy.md) - [IAB CCPA US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string-new.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-global-privacy-protocol-new.md) - [IAB Transparency and Consent Framework (TCF)](https://developer.onetrust.com/onetrust/docs/iab-tcf-22-new.md) - [Right-To-Left (RTL) Support](https://developer.onetrust.com/onetrust/docs/rtl-support.md) - [Initialize the SDK](https://developer.onetrust.com/onetrust/docs/configure-sdk-parameters-new.md) - [Display User Interfaces](https://developer.onetrust.com/onetrust/docs/display-user-interfaces-new.md) - [Download the SDK](https://developer.onetrust.com/onetrust/docs/download-sdk-new.md) - [Migrating from the Legacy SDK to the CMP API](https://developer.onetrust.com/onetrust/docs/migrating-from-the-legacy-sdk-to-the-new-cmp-sdk.md): This page is only relevant if you are using a legacy SDK and need to adopt the CMP API solution. - [When Consent Changes](https://developer.onetrust.com/onetrust/docs/when-consent-changes-new.md) - [HTML5 SDK - Tizen and WebOS](https://developer.onetrust.com/onetrust/docs/tizen-and-webos-sdk-new.md) - [URLs called by the OneTrust Mobile SDKs](https://developer.onetrust.com/onetrust/docs/urls-called-by-the-onetrust-sdk.md) - [IAB Global Privacy Protocol](https://developer.onetrust.com/onetrust/docs/iab-gpp.md) - [IAB TCF 2.3](https://developer.onetrust.com/onetrust/docs/iab-transparency-and-consent-framework-22.md) - [Get Banner UI](https://developer.onetrust.com/onetrust/docs/get-banner-ui.md): Retrieve the required attributes to render the banner UI - [Get Preference Center UI](https://developer.onetrust.com/onetrust/docs/get-preference-center-ui.md): Retrieve the required attributes to render the preference center UI - [Get Universal Consent Preferences UI](https://developer.onetrust.com/onetrust/docs/get-universal-consent-preferences.md): Retrieve the required attributes to render the Mobile Universal Consent Preference Center UI - [Get Vendor List UI](https://developer.onetrust.com/onetrust/docs/get-vendor-list-ui.md): Retrieve the required attributes to render the vendor list UI - [Implementation Guidance](https://developer.onetrust.com/onetrust/docs/implementation-guidance.md): This page walks you through how to implement the CMP API solution in your application. - [Persisting Consent](https://developer.onetrust.com/onetrust/docs/persisting-consent.md): This page describes how consent persists from one instance to the next. - [Save and Log Consent](https://developer.onetrust.com/onetrust/docs/save-and-log-consent.md): Save and log consent to OneTrust servers. - [Introduction](https://developer.onetrust.com/onetrust/docs/server-side-cmp-api-introduction.md) - [AMP Integration](https://developer.onetrust.com/onetrust/docs/amp-integration.md) - [Bulk Domain Management](https://developer.onetrust.com/onetrust/docs/bulk-domain-management.md) - [Custom Common CSS and JavaScript](https://developer.onetrust.com/onetrust/docs/common-custom-css.md) - [Configuring a Content Security Policy with OneTrust CDN](https://developer.onetrust.com/onetrust/docs/content-security-policy-cdn.md) - [Cookie Consent Support for AMP Websites](https://developer.onetrust.com/onetrust/docs/cookie-consent-support-for-amp-websites.md) - [Custom Common HTML](https://developer.onetrust.com/onetrust/docs/custom-common-html.md) - [Custom Geolocation Integration](https://developer.onetrust.com/onetrust/docs/custom-geolocation-integration.md) - [Display Preference Center on Script Load](https://developer.onetrust.com/onetrust/docs/display-preference-center.md) - [PRA/DSAR - Web CMP Opt Out](https://developer.onetrust.com/onetrust/docs/dsarpra-web-cmp-opt-out.md) - [IAB CCPA: Configuring the US Privacy String](https://developer.onetrust.com/onetrust/docs/iab-ccpa-us-privacy-string.md) - [IAB TCF Developer Guide](https://developer.onetrust.com/onetrust/docs/iab-tcf-developer-guide.md) - [Web CMP JavaScript Methods](https://developer.onetrust.com/onetrust/docs/javascript-api.md): This page provides a list of all public methods exposed by the Web CMP script. - [Web CMP Events Guide](https://developer.onetrust.com/onetrust/docs/javascript-events-guide.md) - [Multi-Touch Consent](https://developer.onetrust.com/onetrust/docs/multi-touch-consent.md) - [Server Side Rendering Performance & Availability](https://developer.onetrust.com/onetrust/docs/server-side-rendering-performance-availability.md) - [Single Page Applications](https://developer.onetrust.com/onetrust/docs/single-page-applications.md) - [Google Consent Mode](https://developer.onetrust.com/onetrust/docs/using-google-consent-mode.md) - [Using TCF with Header Bidding (TCF Stub)](https://developer.onetrust.com/onetrust/docs/using-tcf-with-header-bidding.md) - [Using TCF with Prebid](https://developer.onetrust.com/onetrust/docs/using-tcf-with-prebid.md) - [BigCommerce](https://developer.onetrust.com/onetrust/docs/bigcommerce.md) - [Shopify](https://developer.onetrust.com/onetrust/docs/ecommerce.md) - [Ensighten](https://developer.onetrust.com/onetrust/docs/ensighten.md) - [Facebook Pixel](https://developer.onetrust.com/onetrust/docs/facebook-pixel.md) - [Google Tag Manager](https://developer.onetrust.com/onetrust/docs/google-tag-manager.md) - [HubSpot](https://developer.onetrust.com/onetrust/docs/hubspot.md) - [Connecting the OneTrust CMP to Third-Party Platforms](https://developer.onetrust.com/onetrust/docs/connect-cmp-to-third-party-platforms.md) - [Magento](https://developer.onetrust.com/onetrust/docs/magento.md) - [Marketo Landing Page](https://developer.onetrust.com/onetrust/docs/marketo-landing-page.md) - [mParticle](https://developer.onetrust.com/onetrust/docs/mparticle.md) - [Squarespace](https://developer.onetrust.com/onetrust/docs/squarespace.md) - [Tealium Tag Manager](https://developer.onetrust.com/onetrust/docs/tealium-tag-manager.md) - [Weebly](https://developer.onetrust.com/onetrust/docs/weebly.md) - [Performance and Availability of the Cookie Consent Script](https://developer.onetrust.com/onetrust/docs/performance-availability-cookie-script.md) ## API Reference - [Get List of Relationship Records by Entity](https://developer.onetrust.com/onetrust/reference/getrelatedentitiesforanentityusingpost.md): Use this API to retrieve a list of relationship records by entity. > 🗒 Things to Know> > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents).> - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Add Attribute to Schema](https://developer.onetrust.com/onetrust/reference/addattributeusingpost.md): Use this API to add an attribute to a specific schema. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Add Options to Attribute](https://developer.onetrust.com/onetrust/reference/addoptionsusingpost-1.md): Use this API to add options to an attribute. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Disable Attribute](https://developer.onetrust.com/onetrust/reference/disableattributeusingput-1.md): Use this API to disable an attribute. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Enable Attribute](https://developer.onetrust.com/onetrust/reference/enableattributeusingput-1.md): Use this API to enable an attribute. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Create Entity](https://developer.onetrust.com/onetrust/reference/addentityusingentitytypeidorentitytypenameusingpost-1.md): Use this API to create a new entity record. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Delete Entity](https://developer.onetrust.com/onetrust/reference/deleteusingentitytypeidorentitytypenameusingdelete-1.md): Use this API to delete an existing entity record. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Get Full Entity Details](https://developer.onetrust.com/onetrust/reference/findallbytypeidandcriteriausingpost-1.md): Use this API to retrieve all the details for the specified entity record by key terms and filters. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Get Basic Entity Details](https://developer.onetrust.com/onetrust/reference/findentitybasicdetailsbytypeandcriteriausingpost-1.md): Use this API to retrieve basic details for the specified entity record by key terms and filters. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Get Entity](https://developer.onetrust.com/onetrust/reference/getentityinformationusingentitytypeidorentitytypenameusingget-1.md): Use this API to retrieve a single entity record by its unique identifier along with the associated attributes, module name, and created date. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Modify Entity](https://developer.onetrust.com/onetrust/reference/updateusingentitytypeidorentitytypenameusingpatch-1.md): Use this API to partially update an existing entity record. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Get List of Entity Types](https://developer.onetrust.com/onetrust/reference/findallbytypeandcriteriausingpost_1.md): Use this API to retrieve a list of all entity types by key terms and filters. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Get Entity Type](https://developer.onetrust.com/onetrust/reference/getentitytypeinformationusingget_1-1.md): Use this API to retrieve the details for the specified entity type. The response will return the user who created the entity type, created date, and description. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Update Entity Workflow Stage](https://developer.onetrust.com/onetrust/reference/assignstagebyname-2.md): Use this API to update the workflow stage for the specified entity record. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Create Relationship Record between Entities](https://developer.onetrust.com/onetrust/reference/createlinkrecordbetweenentitiesusinglinktypeidusingpost-1.md): Use this API to create a new Relationship Record between entities. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Remove Relationship Record](https://developer.onetrust.com/onetrust/reference/deletelinkrecordbyidandtypeusinglinktypeidusingdelete-1.md): Use this API to remove an existing Relationship Record between entities. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Get Relationship Record](https://developer.onetrust.com/onetrust/reference/getlinkrecordinformationusinglinktypeidusingget-1.md): Use this API to retrieve the details of a specific Relationship Record between entities. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Create Task](https://developer.onetrust.com/onetrust/reference/createtaskusingpost_1-1.md): Use this API to create a new task for an entity. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Get Task](https://developer.onetrust.com/onetrust/reference/findtaskusingget_1-1.md): Use this API to retrieve a specific task on an entity. The response will include details such as the activity history, assignee, and deadline. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Update Task](https://developer.onetrust.com/onetrust/reference/updatetaskusingput_1-1.md): Use this API to update an existing task for an entity. > 🗒 Things to Know > > - This API only supports AI Governance entities (Models, Datasets, AI Systems, and AI Agents). > - AI Governance APIs will become available over the course of the Spring as customer tenants are migrated to enhanced AI Governance services. No customer action is required and more detailed information will be published in upcoming release notes and product documentation. - [Creating a New Cookie Runner Script](https://developer.onetrust.com/onetrust/reference/creating-a-new-cookie-runner-script.md) - [Custom Scan using Worker Node APIs](https://developer.onetrust.com/onetrust/reference/custom-scan-using-worker-node-apis.md) - [Managing Organizations](https://developer.onetrust.com/onetrust/reference/managing-organizations.md) - [Managing Users](https://developer.onetrust.com/onetrust/reference/managing-users.md) - [Updating a User's Role & Organization](https://developer.onetrust.com/onetrust/reference/updating-a-users-role-organization.md) - [Integrating with Webhooks](https://developer.onetrust.com/onetrust/reference/integrating-with-webhooks.md) - [Updating a Control Implementation](https://developer.onetrust.com/onetrust/reference/updating-a-control-implementation.md) - [Updating Risk Details](https://developer.onetrust.com/onetrust/reference/updating-risk-details.md) - [Importing GDPR Transfer Impact Assessment Template into the OneTrust Application](https://developer.onetrust.com/onetrust/reference/importing-gdpr-transfer-impact-assessment-template-into-onetrust.md) - [Managing Policies and Notices](https://developer.onetrust.com/onetrust/reference/managing-policies-and-notices.md) - [Bulk Export Demo Videos](https://developer.onetrust.com/onetrust/reference/bulk-export-demo-videos.md) - [Embedding the Trust Center on an existing webpage](https://developer.onetrust.com/onetrust/reference/embedding-the-trust-center-on-an-existing-webpage.md) - [API Use Cases & Best Practices](https://developer.onetrust.com/onetrust/reference/consent-api-use-cases-best-practices.md) - [API Service Level Objectives](https://developer.onetrust.com/onetrust/reference/consent-preference-management-api-service-level-objectives.md) - [Enabling iFraming of a OneTrust Preference Center](https://developer.onetrust.com/onetrust/reference/enabling-iframing-of-a-onetrust-preference-center.md) - [Implementing the Collection Point with REST API](https://developer.onetrust.com/onetrust/reference/implementing-the-collection-point-with-rest-api.md) - [Introducing the V4 Data Subjects APIs](https://developer.onetrust.com/onetrust/reference/introducing-the-v4-data-subjects-apis.md) - [Retrieving Client-Side Consent Preferences using the Preferences API](https://developer.onetrust.com/onetrust/reference/retrieving-client-side-consent-preferences-using-the-preferences-api.md) - [Using Consent Groups to Alter a Data Subject's Consent Status](https://developer.onetrust.com/onetrust/reference/using-consent-groups-to-alter-a-data-subjects-consent-status.md) - [Using the Preference Center Schema to Build Multi Page Preference Centers](https://developer.onetrust.com/onetrust/reference/using-the-preference-center-schema-to-build-multi-page-preference-centers.md) - [Using the Preference Center Schema to Build Original or Enhanced Preference Centers](https://developer.onetrust.com/onetrust/reference/using-the-preference-center-schema-to-build-original-or-enhanced-preference-centers.md) - [V1 to V4 Migration Guide](https://developer.onetrust.com/onetrust/reference/v1-to-v4-migration-guide.md) - [Welcome to the V4 APIs](https://developer.onetrust.com/onetrust/reference/welcome-to-the-v4-apis.md): The Future of Consent and Preference Management - [Deprecated APIs List](https://developer.onetrust.com/onetrust/reference/deprecated-apis-list.md): The following endpoints are deprecated or pending deprecatation: - [OneTrust API Sunsetting & Deprecation Guidelines](https://developer.onetrust.com/onetrust/reference/onetrust-api-sunsetting-deprecation-guidelines.md) - [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview.md) - [Supported Languages and HTML Language Codes](https://developer.onetrust.com/onetrust/reference/supported-languages-and-html-language-codes-1.md) - [System Status](https://developer.onetrust.com/onetrust/reference/system-status.md) - [Understanding & Implementing Pagination](https://developer.onetrust.com/onetrust/reference/understanding-implementing-pagination.md) - [Get Data Subject's Preferences](https://developer.onetrust.com/onetrust/reference/getrealtimepreferences.md): Use this API to retrieve a list of all consent preferences for a data subject identifier. The response will include details such as the consent date, purpose preferences, and data subject's geolocation. The response will also include relevant information about data elements and last interaction date, along with the current status of consent for the purposes that the data subject has interacted with. > 🗒 Things to Know > > - This API uses a JSON Web Token (JWT) authorization token that will be passed to OneTrust servers to ensure authenticated access to a user's consent profile. This is not the OAuth 2.0 client credential or API key. This JWT authorization token is generated using the cross-device consent process. For more information, see [Cross-Domain and Cross-Device Consent](https://my.onetrust.com/s/article/UUID-750c79df-692c-7418-a395-af2acaa45601). > - This API does not require an intermediary server-server API call. It is optimized for client-side applications, maintaining security to make quick decisions based on data subject consent. > - The response of this API will not return updates made via the [Update Data Subject's Preferences in a Preference Center API](https://developer.onetrust.com/onetrust/reference/updatepreferencesfordatasubjectapiusingput). - [Get Banner Data](https://developer.onetrust.com/onetrust/reference/get_banner.md): Use this API to retrieve the required interface attributes to be rendered on the Banner. - [Log Consent](https://developer.onetrust.com/onetrust/reference/post_logconsent.md): Use this API to log consent when a user interacts with a Banner or Preference Center. - [Get Preference Center Data](https://developer.onetrust.com/onetrust/reference/get_preferences.md): Use this API to retrieve the required interface attributes to be rendered on the Preference Center. - [Get Universal Consent Purposes](https://developer.onetrust.com/onetrust/reference/get_ucpurposes.md): Use this API to retrieve the required interface attributes to be rendered for Universal Consent Purposes. - [Get IAB and Google Vendors](https://developer.onetrust.com/onetrust/reference/get_vendors.md): Use this API to retrieve a list of active IAB and Google Vendors to be displayed on the Preference Center. - [Create Consent Receipts in Bulk](https://developer.onetrust.com/onetrust/reference/createbulkconsentreceiptusingpost.md): Use this API when bulk importing consent receipts. This bulk endpoint optimizes performance when processing a large number of consent transactions simultaneously. > 🗒 Things to Know > > - Each collection point must first be set up in the OneTrust Platform to generate a valid JWT, which must be present in the request payload. The JWT can be found on the **Integrations** tab of the **Collection point details** screen or via the [Get Collection Point Token API](https://developer.onetrust.com/onetrust/reference/gettokenusingget). > > - Response times may vary depending on the number of receipts being processed. Consider implementing appropriate timeout handling in your integration. > > - In most cases, further authorization is not required. However, additional information for setting up authenticated consent can be found [here](https://my.onetrust.com/s/article/UUID-b359a104-1900-9ac9-7765-ee08c8047f1d) when needed. > > - OneTrust recommends including no more than 10 purposes per consent receipt, with an absolute maximum of 20 purposes. > > - The default rate limit for imports is 3k Calls/Minute and 3M Receipts/Day. > > - Please validate all inputs before sending data to a Custom API collection point. This API does not perform data type validation to ensure high performance and fast response times. However, invalid data will not be passed to the data subject. - [Create Consent Receipts](https://developer.onetrust.com/onetrust/reference/createconsentreceiptusingpost.md): Use this API to create consent receipts from a collection point. This API is used by all collection points and allows external applications to submit requests to store data subject consent transactions. > 🗒 Things to Know > > - Each collection point must first be set up in the OneTrust Platform to generate a valid JWT, which must be present in the request payload. The JWT can be found on the **Integrations** tab of the **Collection point details** screen within the platform or can be retrieved by calling the [Get Collection Point Token API](https://developer.onetrust.com/onetrust/reference/gettokenusingget). > > - Once the `test` parameter is set to `true`, reverting it to `false` is not possible. However, transitioning from `test=false` to `test=true` is supported. For more information on how to remove the test flag in the OneTrust Platform, see [Managing Data Subject Records](https://my.onetrust.com/s/article/UUID-68370031-bf8a-953e-39a0-5027f766d04f). > > - In most cases, further authorization is not required. However, additional information for setting up authenticated consent can be found [here](https://my.onetrust.com/s/article/UUID-b359a104-1900-9ac9-7765-ee08c8047f1d) when needed. > > - Please avoid passing privacy notices for regular Custom API collection points. OneTrust strongly recommends using `privacyNotices` only for those enabled with dynamic configuration, as they allow you to gather information about all purposes. > > - When passing the `purposes` parameter, the version for `PrivacyNotices` will be used based on the consent date. > > - OneTrust recommends including no more than 10 purposes per consent receipt, with an absolute maximum of 20 purposes. > > - Please validate all inputs before sending data to a Custom API collection point. This API does not perform data type validation to ensure high performance and fast response times. However, invalid data will not be passed to the data subject. - [Create Identified Consent Receipts](https://developer.onetrust.com/onetrust/reference/createidentifiedconsentreceiptusingpost.md): Use this API to create consent receipts for identified data subjects using non-cookie collection points. This endpoint is designed specifically for scenarios where data subjects are identified through explicit identifiers rather than cookies. > 🗒 Things to Know > > - Each collection point must first be set up in the OneTrust Platform to generate a valid JWT, which must be present in the request payload. The JWT can be found on the **Integrations** tab of the **Collection point details** screen or via the [Get Collection Point Token API](https://developer.onetrust.com/onetrust/reference/gettokenusingget). > > - When using this endpoint, you must include an identifier for the data subject, such as an email address or other unique identifier, in the request payload. > > - The identified endpoint creates a persistent record of consent for the data subject that can be managed and updated over time through the OneTrust preference center. > > - If you need to link multiple identifiers to the same data subject, use the `additionalIdentifiers` parameter in your request payload. > > - In most cases, further authorization is not required. However, additional information for setting up authenticated consent can be found [here](https://my.onetrust.com/s/article/UUID-b359a104-1900-9ac9-7765-ee08c8047f1d) when needed. > > - OneTrust recommends including no more than 10 purposes per consent receipt, with an absolute maximum of 20 purposes. > > - Please validate all inputs before sending data to a Custom API collection point. This API does not perform data type validation to ensure high performance and fast response times. However, invalid data will not be passed to the data subject. - [Categorize Cookies by Domain](https://developer.onetrust.com/onetrust/reference/getcategorizedcookiesusingget.md): Use this API to categorize cookies by cookie name and host for the specified domain. The response will return details for each cookie such as pattern (First-Party or Third-Party) and category (Functional, Strictly Necessary, Targeting, Social Media, or Performance) - [Categorize Cookies by Domain and Cookie ID](https://developer.onetrust.com/onetrust/reference/getcategorizedcookieswithcookieidsusingget.md): Use this API to categorize cookies by domain and cookie ID. The response will return details for each cookie such as the pattern (First-Party or Third-Party) and the category (Functional, Strictly Necessary, Targeting, Social Media, or Performance). - [Create Cookie](https://developer.onetrust.com/onetrust/reference/createnewcookie.md): Use this API to create a new cookie. - [Get List of Cookies by Criteria](https://developer.onetrust.com/onetrust/reference/getcookiereportsusingpost.md): Use this API to retrieve a list of all cookies by filter criteria. > 🗒 Things to Know > > - If any of the available languages in the OneTrust application is entered as a value for the `language` parameter, cookie categories, descriptions, and third-party descriptions will be translated accordingly. > - It is recommended to use the `page` and `size` parameters if the number of cookies is greater than 500. - [Update Cookie](https://developer.onetrust.com/onetrust/reference/updatecookie.md): Use this API to update an existing cookie. > 🗒 Things to Know > > - There are two types of IDs for cookies: Cookie ID and Domain Cookie ID. The **Cookies Results All Domains** export can be downloaded from the Categorizations screen in the OneTrust application to select the ID for the `cookieId` parameter. > - For manually created cookies, only `cookieName`, `lifespan`, an `host` will be updated. > - Values must be passed in all the parameters within `descriptionTranslations` for a cookie translation to be updated. - [Create or Update Domain Group](https://developer.onetrust.com/onetrust/reference/createdomaingroupusingpost.md): Use this API to create a new domain group or update an existing domain group. - [Download Script File](https://developer.onetrust.com/onetrust/reference/downloadtolocalusingget.md): Use this API to download the script files for the specified domain. The files will be downloaded within a folder in blob format. > 🗒 Things to Know > > - The domain must be in **Published** status. > 👍 > > For more information, see [Downloading and Deploying Scripts from Local Hosting](https://my.onetrust.com/s/article/UUID-3e2923d6-8364-c2fa-0625-7897395f4cd2?topicId=0TO1Q000000ssJBWAY). - [Get Script for Website](https://developer.onetrust.com/onetrust/reference/getscriptforwebsiteusingget.md): Use this API to retrieve the script for the specified website. - [Publish Script to Website](https://developer.onetrust.com/onetrust/reference/publishtositeusingput.md): Use this API to publish the script configuration options for the specified website. > 👍 > > For more information, see [Publishing and Implementing Cookie Consent Scripts](https://my.onetrust.com/s/article/UUID-7478d3b4-18eb-3ac0-a6fd-fb7ebff9f8dc). - [Get List of Websites](https://developer.onetrust.com/onetrust/reference/getdomainsscannedbysortusingget.md): Use this API to retrieve a list of all websites in the scanner. The response will return websites in **Pending** and **Completed** status along with the corresponding domain ID, external organization ID, and last scanned date. > 🗒 Things to Know > > - It is recommended to use the `page` and `size` parameters if the number of domains is greater than 1,000. - [Add Websites to Scan](https://developer.onetrust.com/onetrust/reference/requestbulkadddomainusingpost.md): Use this API to add a website or multiple websites to the scanner. - [Create Application](https://developer.onetrust.com/onetrust/reference/createapplication.md): Use this API to create a new application for scan and SDK publishing. - [Get Branding Attributes for Application](https://developer.onetrust.com/onetrust/reference/getapplicationbrandingattributelist.md): Use this API to retrieve branding attributes for the specified application. - [Scan Application](https://developer.onetrust.com/onetrust/reference/scanapplication.md): Use this API to initiate an application scan with a file upload. - [Update Branding Attributes for Application](https://developer.onetrust.com/onetrust/reference/updateapplicationbrandingattributesforpublicapi.md): Use this API to update branding attributes for the specified application. - [Add Cookies](https://developer.onetrust.com/onetrust/reference/bulkaddcookies.md): Use this API to add cookies. - [Delete Cookies](https://developer.onetrust.com/onetrust/reference/bulkdeletecookies.md): Use this API to delete cookies by the specified cookie ID or filter criteria. - [Edit Cookies](https://developer.onetrust.com/onetrust/reference/bulkeditcookies.md): Use this API to edit existing cookies. - [Get Categorized Cookies](https://developer.onetrust.com/onetrust/reference/getcategorizedcookies.md): Use this API to retrieve categorized cookies by domain. - [Get List of Cookies by Criteria](https://developer.onetrust.com/onetrust/reference/getcookiesbyfilter.md): Use this API to retrieve a list of cookies by the specified filter criteria. - [Recategorize Cookies](https://developer.onetrust.com/onetrust/reference/recategorizecookiesbyscan.md): Use this API to initiate cookie recategorization for a scan. - [Cancel Scheduled Website Scans](https://developer.onetrust.com/onetrust/reference/bulkcanceldomainschedule.md): Use this API to cancel scheduled scans. - [Create or Update Domain Group](https://developer.onetrust.com/onetrust/reference/createdomaingroup.md): Use this API to create a new domain group or update an existing domain group. - [Delete Domain](https://developer.onetrust.com/onetrust/reference/deletedomain.md): Use this API to delete the specified domain. - [Get Branding Attributes for Domain](https://developer.onetrust.com/onetrust/reference/getbrandingattributelist.md): Use this API to retrieve branding attributes for the specified domain. - [Schedule Website Scans](https://developer.onetrust.com/onetrust/reference/schedulescans.md): Use this API to schedule scans for the specified domains. - [Update Branding Attributes for Domain](https://developer.onetrust.com/onetrust/reference/updatebrandingattributesforpublicapi.md): Use this API to update branding attributes for the specified domain. - [Assign Geolocation Rule Group](https://developer.onetrust.com/onetrust/reference/assignentitiestogeorulegroup.md): Use this API to assign or unassign multiple domains and/or applications to a specified geolocation rule group. For each domain or application, set the value to `true` to assign or `false` to unassign. - [Get Geolocation Rule Group](https://developer.onetrust.com/onetrust/reference/getgeorulegroupdetails.md): Use this API to retrieve detailed information for all geolocation rules within a specified geolocation rule group, including regions, consent model, cookie categories, and other attributes. - [Get List of Geolocation Rule Groups](https://developer.onetrust.com/onetrust/reference/getgeorulegroups.md): Use this API to retrieve a paginated list of geolocation rule groups. The `search` parameter can be used to optionally filter results by name. - [Scan Websites](https://developer.onetrust.com/onetrust/reference/addscans.md): Use this API to start scans for the specified domains. - [Archive Scans](https://developer.onetrust.com/onetrust/reference/archivescans.md): Use this API to archive the specified scans. - [Cancel Scan](https://developer.onetrust.com/onetrust/reference/cancelscan.md): Use this API to cancel a specific scan. - [Get Scan Statuses](https://developer.onetrust.com/onetrust/reference/checkscansstatus.md): Use this API to retrieve the status of the specified scans. - [Get Scan Results](https://developer.onetrust.com/onetrust/reference/getdetailedscanresultinformation.md): Use this API to retrieve results for a specific scan, including details such as cookies, tags, forms, etc. - [Get List of Scans by Domain](https://developer.onetrust.com/onetrust/reference/getdomainscans.md): Use this API to retrieve a list of scans for a specific domain and the specified filter criteria. - [Get List of Websites](https://developer.onetrust.com/onetrust/reference/getdomainsscannedbysort.md): Use this API to retrieve a list of websites in the scanner. The response will return websites in Pending and Completed status for the organization and related child organizations. - [Get List of Added or Removed Cookies](https://developer.onetrust.com/onetrust/reference/getscandeltadetails.md): Use this API to retrieve a list of added or removed cookies between the current and previous scan for the specified domain. - [Get Scan Result Summary](https://developer.onetrust.com/onetrust/reference/getscanresultsummary.md): Use this API to retrieve summary information for a scan, including counts of cookies, tags, forms, and other entities found. - [Download Script File](https://developer.onetrust.com/onetrust/reference/downloadscriptfile.md): Use this API to download the script files for the specified domain. The files will be downloaded within a folder in blob format. > 🗒 Things to Know > > - The domain must be in **Published** status. > 👍 > > For more information, see [Downloading and Deploying Scripts from Local Hosting](https://my.onetrust.com/s/article/UUID-3e2923d6-8364-c2fa-0625-7897395f4cd2). - [Get Script for Application](https://developer.onetrust.com/onetrust/reference/getappscriptdetails.md): Use this API to retrieve script details for the specified application. - [Get Script for Domain](https://developer.onetrust.com/onetrust/reference/getscriptdetails.md): Use this API to retrieve script details for the specified website. - [Get Script for Website](https://developer.onetrust.com/onetrust/reference/getscriptforwebsite.md): Use this API to retrieve the script for the specified website. - [Publish Application SDK](https://developer.onetrust.com/onetrust/reference/publishappscript.md): Use this API to publish the script configuration options for the specified application. - [Publish Script to Website](https://developer.onetrust.com/onetrust/reference/publishscripttosite.md): Use this API to publish the script configuration options for the specified website. > 👍 > > For more information, see [Publishing and Implementing Cookie Consent Scripts](https://my.onetrust.com/s/article/UUID-7478d3b4-18eb-3ac0-a6fd-fb7ebff9f8dc). - [Get Template Details](https://developer.onetrust.com/onetrust/reference/gettemplatedetails.md): Use this API to retrieve detailed information of a template, including banner setup, preference center setup and the cookie list. - [Get List of Templates](https://developer.onetrust.com/onetrust/reference/gettemplates.md): Use this API to retrieve a paginated list of templates with their details, including template name, type, current version, and status. - [Get Domain Data](https://developer.onetrust.com/onetrust/reference/domaindata.md): Use this API to retrieve a list of all templates, cookie consent models, and vendor lists data for the specified domain in JSON format. - [Get Data Subject's Preferences](https://developer.onetrust.com/onetrust/reference/getpreferencesusingget.md): > ❗️ End of Support Notification > > As of November 23, 2025, this API is now deprecated. Any customers leveraging this API are encouraged to use the [Get Data Subject’s Preferences V2 API](https://developer.onetrust.com/onetrust/reference/getrealtimepreferences). For more information, see [OneTrust API Sunsetting & Deprecation Guidelines](https://developer.onetrust.com/onetrust/reference/onetrust-api-sunsetting-deprecation-guidelines). Use this API to retrieve a list of all consent preferences for a data subject identifier. The response will include details such as consent date, Purpose Preferences, and data subject's geolocation. The response will also include relevant information about data elements and last interaction date, along with the current status of consent for the purposes that the data subject has interacted with. > 🗒 Things to Know > > - This API uses an authorization token with public key model that reduces query response time and bypasses rate limits that are in place with the main APIs that rely on querying the main OneTrust database. > - This API does not require an intermediary server-server API call. It is optimized for client-side applications, maintaining security to make quick decisions based on data subject consent. > - The response of this API will not return updates made via the [Update Data Subject's Preferences in a Preference Center](https://developer.onetrust.com/onetrust/reference/updatepreferencesfordatasubjectapiusingput) API. - [Get SDK Configuration](https://developer.onetrust.com/onetrust/reference/applicationdata.md): Use this API to retrieve a list of all templates, cookie consent models, and vendor lists data for the specified mobile or OTT application in JSON format. > 🚧 > > Before calling this API, ensure that the Mobile App data from your OneTrust tenant has been published. For more information, see [Publish Changes](doc:publish-changes). - [Get List of Privacy Notices](https://developer.onetrust.com/onetrust/reference/getprivacynoticesusingget.md): Use this API to retrieve a list of all privacy notices. The response will include details for each privacy notice along with the corresponding privacy notice ID, created date, and last published date. - [Get Privacy Notice Version](https://developer.onetrust.com/onetrust/reference/getprivacynoticeversionbypublisheddateusingget.md): Use this API to retrieve a specific version of the privacy notice by the published date and time. The response will return details on the version of the privacy notice that was most recently published before the value specified in the `date` parameter. - [Get List of Privacy Notice Versions](https://developer.onetrust.com/onetrust/reference/getprivacynoticeversionsusingget.md): Use this API to retrieve a list of versions for a specific privacy notice. - [Create New Collection Point Version](https://developer.onetrust.com/onetrust/reference/createversionusingpost.md): Use this API to create a new version of an existing Collection Point that is currently in **Active** status. A new version of the Collection Point will be created in **Draft** status while the Active version of the Collection Point will remain unchanged. > 🗒 Things to Know > > - Once the Collection Point is in **Draft** status, the Update Existing Collection Point API can be used to edit the Collection Point. Changes will only be visible once the new version of the Collection Point is published. - [Get List of Collection Points](https://developer.onetrust.com/onetrust/reference/getcollectionpointsusingget_1.md): Use this API to retrieve a list of all Collection Points or retrieve a single Collection Point using the `id` query parameter. By default, the response will return details of all versions of a Collection Point with the Active version listed first, but can be filtered using the `status` query parameter. - [Create Collection Point](https://developer.onetrust.com/onetrust/reference/createcollectionpointusingpost.md): Use this API to create a new Collection Point. The Collection Point will be created with version **1** and **Draft** status. > 🗒 Things to Know > > - Data element name values support up to 750 characters. Data element types containing the word **Country** do not support the following characters: [<>();:'“$#}{] > - If the `EnablePrimaryIdentifier` parameter is set to `true`, then the `PrimaryIdentifierType` parameter will be required in the API request body. > - When creating a Web Form Collection Point, the `HostedSDK` parameter value will be set to `true` by default, regardless of the value entered in the request body. > - One of the following parameters is required in the API request body: `PurposeId`, `PurposeIds`, or `PurposeIdsWithVersion`. > - The `PurposeId` and `PurposeIds` parameters can be used to link an **Active** version of a purpose to a Collection Point. > - The `PurposeIdsWithVersion` parameter can be used to link specific versions of a purpose (either in **Draft** or **Active** status) to a Collection Point. - [Update Collection Point Status](https://developer.onetrust.com/onetrust/reference/disablecollectionpointusingput.md): Use this API to update the status of a Collection Point. > 🗒 Things to Know > > - To disable the Collection Point, set the `value` query parameter to `true`. All versions of the Collection Point will be disabled from ingesting receipts. > - To enable the Collection Point, set the `value` query parameter to `false`. The previous status of the Collection Point will be restored. > - The following Collection Point types cannot be disabled: ADMIN_UPDATE and NOTIFICATION_OPT_OUT. - [Update Existing Collection Point](https://developer.onetrust.com/onetrust/reference/editcollectionpointusingput.md): Use this API to update an existing Collection Point. Before calling this API, ensure that the Collection Point is in **Draft** status. If the Collection Point is in **Active** status, use the Create New Collection Point Version API to create a new version of the Collection Point. > 🗒 Things to Know > > - One of the following parameters must be included in the API request body: `PurposeId`, `PurposeIds`, or `PurposeIdsWithVersion`. > - The `PurposeId` and `PurposeIds` parameters can be used to link an **Active** version of a purpose to a Collection Point. > - The `PurposeIdsWithVersion` parameter can be used to link specific versions of a purpose (either in **Draft** or **Active** status) to a Collection Point. - [Get List of Collection Points](https://developer.onetrust.com/onetrust/reference/getcollectionpointsusingget.md): Use this API to retrieve a list of all Collection Points. The response will include relevant details for each Collection Point, including purposes, notices, data elements, and more. - [Get Collection Point Token](https://developer.onetrust.com/onetrust/reference/gettokenusingget.md): Use this API to retrieve the JSON Web Token (JWT) for a given Collection Point. The JWT returned in the response can be used as the `requestInformation` parameter value in the Consent Receipts API in order to pass data subject consent transactions. - [Download All Consent Attachments](https://developer.onetrust.com/onetrust/reference/downloadconsentattachments.md): Use this API to retrieve all available file references attached to a given data subject. The files will be downloaded in .zip format. - [Download Consent Attachment](https://developer.onetrust.com/onetrust/reference/downloadgivenconsentattachments.md): Use this API to download a specific file reference attached to a given data subject. The file will be downloaded in .zip format. > 🗒 Things to Know > > - The `attachmentId` parameter value corresponds to the `RefId` parameter value returned after uploading a file using the [Upload Consent Attachment](https://developer.onetrust.com/onetrust/reference/uploadconsentattachments) API. - [Remove All Consent Attachments](https://developer.onetrust.com/onetrust/reference/removeallconsentattachmentrefs.md): Use this API to remove all file references attached to a given data subject. - [Remove Consent Attachment](https://developer.onetrust.com/onetrust/reference/removegivenconsentattachmentrefs.md): Use this API to remove a specific file reference attached to a given data subject. > 🗒 Things to Know > > - The `attachmentId` parameter value corresponds to the `RefId` parameter value returned after uploading a file using the [Upload Attachments](https://developer.onetrust.com/onetrust/reference/uploadconsentattachments) API. - [Upload Consent Attachment](https://developer.onetrust.com/onetrust/reference/uploadconsentattachments.md): Use this API to upload and store files which contain written consent of data subjects' transactions. > 🗒 Things to Know > > - The size of uploaded files must be less than 4MB. > > - The following file formats are allowed: .pdf, .jpeg, .jpg, and .png. > > - The `RefID` parameter returned within the response body can be used to attach file references to incoming data subject consents using the [Create Consent Receipts](https://developer.onetrust.com/onetrust/reference/createconsentreceiptusingpost) API. > > - File references can be attached to a given data subject or data subject purpose by using the `attachments` or `PurposeAttachments` parameters in the [Create Consent Receipts](https://developer.onetrust.com/onetrust/reference/createconsentreceiptusingpost) API respectively. - [Add Consent Groups to Parent Consent Group](https://developer.onetrust.com/onetrust/reference/addconsentgroupstoconsentgroupusingpost.md): Use this API to add Consent Groups as children of the specified Parent Consent Group. > 🗒 Things to Know > > - A Consent Group can only be added as a child to one Parent Consent Group. > - A Parent Consent Group can either have Consent Groups as children or data subjects as children within a given level in the hierarchy, not both. If Consent Groups are added as children to the Parent Consent Group, data subjects cannot be added to the Parent Consent Group at that given level. > - Consent Groups can support a hierarchical structure of up to 4 levels. However, once data subjects are added as children to a Parent Consent Group, no additional Consent Groups can be added to that hierarchical structure. - [Add Data Subjects to Parent Consent Group](https://developer.onetrust.com/onetrust/reference/adddatasubjectstoconsentgroupusingpost.md): Use this API to add data subjects as children of the specified Parent Consent Group. > 🗒 Things to Know > > - A Parent Consent Group can either have Consent Groups as children or data subjects as children within a given level in the hierarchy, not both. If data subjects are added as children to the Parent Consent Group, Consent Groups cannot be added to the Parent Consent Group at that given level or any level below in the hierarchical structure. - [Add Purpose Rules to Consent Group](https://developer.onetrust.com/onetrust/reference/addpurposerulestoconsentgroupusingpost.md): Use this API to add Purpose Rules to a Consent Group. These rules will dictate which Purposes will be overridden with the defined Enforced Status for data subjects within the given Consent Group. > 🗒 Things to Know > > - Each Purpose in a Consent Group has its own Purpose Rule which is comprised of an Enforced Status and Effective Status. > - The Enforced Status is the Purpose Status that you want to apply for a particular Purpose. > - The Effective Status is calculated using the Priority Scores across the entire Consent Group hierarchy for each Purpose. - [Create Consent Group](https://developer.onetrust.com/onetrust/reference/createconsentgroupusingpost.md): Use this API to create a new Consent Group by providing a name, description, and optional external name. > 🗒 Things to Know > > - If an external name is not defined, one will be generated automatically. - [Remove Purpose Rule from Consent Group](https://developer.onetrust.com/onetrust/reference/deleteconsentgrouppurposeruleusingdelete.md): Use this API to remove existing Purpose Rules from a Consent Group. - [Remove Data Subject from Parent Consent Group](https://developer.onetrust.com/onetrust/reference/deletedatasubjectstoconsentgroupusingdelete.md): Use this API to remove a single data subject as a child of the specified Parent Consent Group. > 🗒 Things to Know > > - Only one data subject can be removed per API call. - [Get List of Consent Groups](https://developer.onetrust.com/onetrust/reference/getconsentgrouplistusingget.md): Use this API to retrieve a list of all Consent Groups along with details such as the Consent Group ID, associated Purpose Rules, and the list of data subjects and/or Consent Groups within its hierarchal structure. - [Get Priority Scores for Purpose Statuses](https://developer.onetrust.com/onetrust/reference/getconsentgroupsettingsusingget.md): Use this API to retrieve the Priority Scores for each Purpose Status. > 🗒 Things to Know > > - All Purpose Statuses are given a Priority Score. A Purpose Status with a lower Priority Score will be given precedence over a Purpose Status with a higher Priority Score. > - Each Purpose in a Consent Group has its own Purpose Rule which is comprised of an Enforced Status and Effective Status. > - The Enforced Status is the Purpose Status that you want to apply for a particular Purpose. > - The Effective Status is calculated using the Priority Scores across the entire Consent Group hierarchy for each Purpose. > 👍 > > For more information, see [Using Consent Groups to Alter a Data Subject's Consent Status](https://developer.onetrust.com/onetrust/docs/using-consent-groups-to-alter-a-data-subjects-consent-status). - [Get Consent Group](https://developer.onetrust.com/onetrust/reference/getconsentgroupusingget.md): Use this API to retrieve a single Consent Group by its unique identifier along with details such as the Consent Group ID, associated Purpose Rules, and the list of data subjects and/or Consent Groups within its hierarchal structure. - [Remove Consent Groups from Parent Consent Group](https://developer.onetrust.com/onetrust/reference/unlinkconsentgroupusingdelete.md): Use this API to remove Consent Groups as children of the specified Parent Consent Group. > 🗒 Things to Know > > - Multiple Consent Groups can be removed within the same API call by specifying the list of child Consent Group IDs. - [Update Priority Scores for Purpose Statuses](https://developer.onetrust.com/onetrust/reference/updateconsentgroupsettingsusingput.md): Use this API to update the current Priority Score values for the Purpose Statuses. Priority Scores across the entire Consent Group hierarchy are used to calculate the Effective Status of a Purpose. > 🗒 Things to Know > > - All Purpose Statuses are given a Priority Score. A Purpose Status with a lower Priority Score will be given precedence over a Purpose Status with a higher Priority Score. Any new Purpose Statuses will automatically be given a higher priority score by default. > - When calculating the Effective Status of any Purpose in a Consent Group: > - If there is no Parent Consent Group, the Effective Status becomes the same as the Enforced Status. > - If there is a Parent Consent Group, the Effective Status would be calculated by comparing the Priority Score of the Enforced Status of the Purpose at that hierarchy level with the Priority Score of the Effective Status of the Purpose in the Parent level and applying the status associated with the lower Priority Score. > 👍 > > For more information, see [Using Consent Groups to Alter a Data Subject's Consent Status](https://developer.onetrust.com/onetrust/docs/using-consent-groups-to-alter-a-data-subjects-consent-status). - [Update Consent Group Purpose Rule](https://developer.onetrust.com/onetrust/reference/updatepurposerulestoconsentgroupusingput.md): Use this API to update existing Purpose Rules within a Consent Group. - [Delete Cross Device Consents and Receipts](https://developer.onetrust.com/onetrust/reference/crossdeviceconsentusingdelete.md): Use this API to delete cross device consents and the related receipts. This API is designed for users with a CRO license. However, users with both UCPM and CRO licenses, can use the [Delete Data Subjects](https://developer.onetrust.com/onetrust/reference/deletedatasubjectprofileusingdelete) API to delete CRO data subject identifiers. > 🗒 Things to Know > > - A maximum of 1000 data subject identifiers can be deleted per request. > - Requests will be processed asynchronously. - [Create Data Subject Group](https://developer.onetrust.com/onetrust/reference/createdatasubjectgroupv4.md): Use this API to create a new Data Subject Group. > 🗒 Things to Know > > - Data Subject Groups must contain at least one primary data subject identifier and two data subjects. - [Get List of Data Subject Groups](https://developer.onetrust.com/onetrust/reference/getdatasubjectgroupslistv4.md): Use this API to retrieve a list of Data Subject Groups. - [Get List of Data Subject Group Members](https://developer.onetrust.com/onetrust/reference/getlinkedidentitygroupmembersv4.md): Use this API to retrieve a list of all members of a data subject group. - [Get List of Data Subject Group Associations by Data Subject](https://developer.onetrust.com/onetrust/reference/getlinkedidentitygroupsbydatasubjectv4.md): Use this API to retrieve details about a data subject's associations with Data Subject Groups. > 🗒 Things to Know > > - If the `linkedIdentityGroupId` parameter is passed, the response will include details for the data subject's association with the specified Data Subject Group. If not passed, the response will include details for the data subject's associations with all Data Subject Groups in which the data subject is a member. - [Update Data Subject Group](https://developer.onetrust.com/onetrust/reference/updatedatasubjectgroupv4.md): Use this API to update an existing Data Subject Group. > 🗒 Things to Know > > - Data Subject Groups must contain at least one primary data subject identifier and two data subjects. > - To update the Data Subject Group name, use the `groupName` parameter and enter a new name different from the one already in use. - [Create Data Subject Group](https://developer.onetrust.com/onetrust/reference/createlinkedidentitygroupusingpost.md): Use this API to create a new Data Subject Group. > 🗒 Things to Know > > - Data Subject Groups must contain at least one primary data subject identifier and two data subjects. - [Delete Data Subject Group](https://developer.onetrust.com/onetrust/reference/deleteusingdelete.md): Use this API to delete an existing Data Subject Group. - [Get List of Data Subject Groups](https://developer.onetrust.com/onetrust/reference/getlinkedidentitygroupsusingget.md): Use this API to retrieve a list of all Data Subject Groups. The response will include the Data Subject Group ID, number of data subjects, and details of the primary data subjects in the group. - [Get Data Subject Group](https://developer.onetrust.com/onetrust/reference/getlinkedidentitygroupusingget.md): Use this API to retrieve a single Data Subject Group by its unique identifier along with details such as the Data Subject Group ID and the list of data subjects within its group. - [Update Data Subject Group](https://developer.onetrust.com/onetrust/reference/updatelinkedidentitygroupusingput.md): Use this API to update an existing Data Subject Group. > 🗒 Things to Know > > - Data Subject Groups must contain at least one primary data subject identifier and two data subjects. > - To update the Data Subject Group name, use the `groupName` parameter and enter a new name different from the one already in use. - [Delete Purposes from Data Subject](https://developer.onetrust.com/onetrust/reference/deletedatasubjectprofilesusingdelete.md): Use this API to delete up to 100 purposes from one data subject or to delete one purpose from up to 100 data subjects. > 🗒 Things to Know > > - By default, related data subject transactions will be removed from the database and will no longer appear in the OneTrust Platform UI after calling this API. However, the transactions can still be retrieved using the [Get List of Receipts API](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingpost). To maintain data subject transactions in the database and OneTrust Platform UI, set the `retainTransactions` parameter to `true`. - [Delete Data Subjects](https://developer.onetrust.com/onetrust/reference/deletedatasubjectprofileusingdelete.md): Use this API to delete data subjects. Deleting data subjects is a permanent action that should be exercised with caution. > 🗒 Things to Know > > - Data subjects can be deleted using any of the following values at a time: > - List of Identifiers > - List of Data Subject Identifier GUIDs > - Date range between `fromCreatedDate` and `toCreatedDate` (the timespan must be 24 hours or less). > - Date range between `fromInteractionDate` and `toInteractionDate` (the timespan must be 24 hours or less). > - When filtering by date range, created date and interaction date should be used separately. They should not be used at the same time. > - Up to 999 data subject identifiers can be deleted per API call. > - If a new data subject has to be deleted, it is recommended to wait at least 24 hours after its creation to ensure that all the data has been properly stored and synchronized before removal. > - Requests will be processed asynchronously and can be monitored in the View Activity option in the Data Subject list view within the OneTrust Platform. If multiple calls are required, wait until each request processes before making another call. > - By default, related data subject receipts and transactions will be removed from the database and will no longer appear in the OneTrust Platform UI after calling this API. However, the receipts and transactions can still be retrieved using the [Get List of Receipts API](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingpost). To maintain data subject receipts and transactions in the database and OneTrust Platform UI, set the `retainReceiptsTransactions` parameter to `true`. > 👍 > > The **Enable Data Subject Deletion** setting must be enabled within Global Settings in the OneTrust application in order to use this API. For more information, see [Deleting Data Subject Records](https://my.onetrust.com/s/article/UUID-73ac74f6-edc7-3344-e86e-e810660154e9?topicId=0TO1Q000000ItSSWA0). - [Delete Purpose from Data Subjects](https://developer.onetrust.com/onetrust/reference/deletepurposefromdatasubjectusingdelete.md): Use this API for large scale deletion of a specific purpose from all data subjects. > 🗒 Things to Know > > - A data subject exclusion list is required to provide the specific data subjects from which the purpose should not be deleted. The **Consent DS Exclusion** import template within Global Settings in the OneTrust Platform can be used to create the data subject exclusion list and can be imported via Bulk Import in the application or via API. > - Once the data subject exclusion list has been successfully imported, either an `importID` or `jobGuid` parameter value must be specified in the request body. > - Data subject exclusion lists are valid during the next 30 days after submission. > - To override the data subject exclusion list requirement, set the `deletePurposeFromAllDataSubjects` parameter value to `true`. By default, this parameter is set to `false`. > - By default, related data subject transactions will be removed from the database and will no longer appear in the OneTrust Platform UI after calling this API. However, the transactions can still be retrieved using the [Get List of Receipts API](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingpost). To maintain data subject transactions in the database and OneTrust Platform UI, set the `retainTransactions` parameter to `true`. - [Get List of Data Subjects](https://developer.onetrust.com/onetrust/reference/getdatasubjectsusingget.md): Use this API to retrieve a list of all data subjects. The response will include details for each data subject such as the associated data elements, data subject ID, and data subject identifier. By default, the response will return data subject details sorted in descending order of last modified date. > 🗒 Things to Know > > - This API is not designed to be used in synchronous workflows. As an alternative, the [Gets preferences for a Data Subject](https://developer.onetrust.com/onetrust/reference/getpreferencesusingget) API can be called. > 🚧 > > Please note that the FTC Do Not Call List is updated once daily and not updated in real time. As such, there may be a possibility that a consumer's preferences may have changed and they may have opted out of receiving communication before the Do Not Call list gets refreshed. OneTrust is merely conveying information received from the FTC and is not responsible for compiling the lists. - [Search Data Subjects](https://developer.onetrust.com/onetrust/reference/searchdatasubjectspostusingpost.md): Use this API to search for data subjects based on various criteria. The response will include details for each matching data subject such as the associated data elements, data subject ID, and data subject identifier. > 🗒 Things to Know > > - This API supports complex search criteria including filtering by data elements, purposes, and consent status. > - For large result sets, use pagination to retrieve data in manageable chunks. > - The response can be customized using the properties parameter to include or exclude certain data. > 🚧 > > Please note that the FTC Do Not Call List is updated once daily and not updated in real time. As such, there may be a possibility that a consumer's preferences may have changed and they may have opted out of receiving communication before the Do Not Call list gets refreshed. OneTrust is merely conveying information received from the FTC and is not responsible for compiling the lists. - [Get List of Data Subjects](https://developer.onetrust.com/onetrust/reference/getv3datasubjectprofilesusingpost.md): > ❗️ Migration Recommendation > > Please, do not adopt this API if you have not already done so. Continue to use the [Get List of Data Subjects](https://developer.onetrust.com/onetrust/reference/getdatasubjectprofileusingget) V1 API or request access to have Data Subjects V4 APIs enabled. Use this API to retrieve a list of all data subjects. Depending on the query or header parameter values passed in the request, the response will return specific details about data subjects, including relevant information about the latest Collection Point update. > 🗒 Things to Know > > - This API can also be used to retrieve the magic link token as `linkToken` in the response. > > - The `identifier` header parameter can be used to return information for a single data subject. > > - This API is designed to remain available during maintenance periods. > > - This API is not designed to be used in workflows. - [Get Data Subject](https://developer.onetrust.com/onetrust/reference/getv3datasubjectsprofileusingget.md): > ❗️ Migration Recommendation > > Please, do not adopt this API if you have not already done so. Continue to use the [Get List of Data Subjects](https://developer.onetrust.com/onetrust/reference/getdatasubjectprofileusingget) V1 API or request access to have Data Subjects V4 APIs enabled. Use this API to retrieve a single data subject using the `identifer` header parameter. > 🗒 Things to Know > > - This API can also be used to retrieve the magic link token as `linkToken` in the response. > - This API will remain available during maintenance periods. > - This API is not designed to be used in workflows. - [Delete Data Subject](https://developer.onetrust.com/onetrust/reference/deletedatasubjectusingttl.md): Initiates a TTL-based deletion process for a data subject - [Delete Purposes from Data Subject](https://developer.onetrust.com/onetrust/reference/deletepurposefromdatasubjectsusingttl.md): Initiates TTL-based deletion of specific purposes from data subjects - [Get List of All Purpose Details by Data Subject](https://developer.onetrust.com/onetrust/reference/getallprofilesbydatasubjectv4.md): Use this API to retrieve a data subject’s purpose details for all purposes. The response will include all purposes that the data subject interacted with along with details such as status, last transaction date, consent date, and purpose preferences. - [Get Data Subject](https://developer.onetrust.com/onetrust/reference/getdatasubjectbasicdetailsv4.md): Use this API to retrieve a data subject’s basic details. The response will include details such as the data subject’s created date, last transaction date, and data elements. - [Get Data Subject Details](https://developer.onetrust.com/onetrust/reference/getdatasubjectdetailsv4.md): Use this API to retrieve complete details for a specific data subject. The response will include all of the data subject’s basic details, purpose details, and email link tokens. - [Get Optimized List of All Purpose Details for All Data Subjects](https://developer.onetrust.com/onetrust/reference/getdatasubjectprofilesunorderedv4.md): Use this optimized for high-performance API to retrieve an unsorted list of purpose details last updated between the specified date range for all data subjects. > 🗒 Things to Know > > - The maximum date range that can be returned is 7 days. > - Results are not returned in a specific order and may appear random. > - Supports bookmarking for consistent pagination. > - Optimized for high-performance bulk retrieval where sorting is not required. > - Has more flexible rate limits compared to the standard [Get List of All Purpose Details for All Data Subjects](/onetrust/reference/getdatasubjectprofilesv4) API. - [Get List of All Purpose Details for All Data Subjects](https://developer.onetrust.com/onetrust/reference/getdatasubjectprofilesv4.md): Use this API to retrieve a list of all purpose details last updated between a specified date range for all data subjects. > 🗒 Things to Know > > - The maximum date range that can be returned is 7 days. - [Get Purpose Details by Data Subject](https://developer.onetrust.com/onetrust/reference/getdatasubjectprofilev4.md): Use this API to retrieve a data subject’s purpose details for a specific purpose. The response will include details such as the last transaction date, consent date, and purpose preferences. - [Get Optimized List of Data Subjects](https://developer.onetrust.com/onetrust/reference/getdatasubjectsunorderedv4.md): Use this optimized for high-performance API to retrieve a list of unsorted data subjects that were last updated between the specified date range. The response includes key details such as each data subject’s identifier, created date, data elements, and last updated date. > 🗒 Things to Know > > - The maximum date range that can be returned is 7 days. > - Results are not returned in a specific order and may appear random. > - Supports bookmarking for consistent pagination. > - Optimized for high-performance bulk retrieval where sorting is not required. > - Has more flexible rate limits compared to the standard [Get List of Data Subjects](/onetrust/reference/getdatasubjectsv4) API. - [Get List of Data Subjects](https://developer.onetrust.com/onetrust/reference/getdatasubjectsv4.md): Use this API to retrieve a list of data subjects that were last updated between the specified date range. The response will include basic details, such as each data subject’s identifier, created date, data elements, and last updated date. > 🗒 Things to Know > > - The maximum date range that can be returned is 7 days. - [Update Data Subject's Data Elements](https://developer.onetrust.com/onetrust/reference/createorupdatedatasubjectusingpost.md): Use this API to create a new data subject or update an existing data subject. The data subject will be created or updated with the details provided in the request body. > 🗒 Things to Know > > - The data subject primary identifier cannot be updated. However, additional identifiers can be added, updated, or deleted: > - To add or update an additional identifier for a given data subject, set the `linked` parameter value to `true` and include a list of the additional identifiers within the `value` parameter. > - To remove an additional identifier from a given data subject, set the `linked` parameter value to `true` and leave the `value` parameter empty. Removed identifiers will remain associated with the data subject as data elements. > - This API is not designed to be used in synchronous workflows and will not trigger integration events or reporting updates. Below are templated examples of adding, editing, and deleting additional identifiers for the data subject. ```json Add { "dataElements": [ { "name": "ADDITIONAL_IDENTIFIER_TYPE", // For example: Email "linked": true, // When dealing with identifiers, set this value to true "value": ["EXISTING IDENTIFIER", "NEW_IDENTIFIER"] // Make sure to keep the existing identifier if you already have one for that type } ] } ``` ```json Edit { "dataElements": [ { "name": "ADDITIONAL_IDENTIFIER_TYPE", // For example: Email "linked": true, // When dealing with identifiers, set this value to true "value": ["EDITED IDENTIFIER"] // Make sure to keep the existing identifier if you already have one for that type } ] } ``` ```json Delete { "dataElements": [ { "name": "ADDITIONAL_IDENTIFIER_TYPE", // For example: Email "linked": true, // When dealing with identifiers, set this value to true "value": [] // Keep empty if you want to remove all additional identifiers that share the identifier type } ] } ``` - [Get List of Data Subjects](https://developer.onetrust.com/onetrust/reference/getdatasubjectprofileusingget.md): Use this API to retrieve a list of all data subjects. The response will include details for each data subject such as data elements, purposes, associated topics, and purpose preferences. The response will also include relevant information about the latest Collection Point interactions and receipt IDs, along with the current status of consent for the purposes and preferences they have interacted with. > 🗒 Things to Know > > - It is critical that all queries include `properties=ignoreCount`. Not including `ignoreCount` will significantly decrease performance. If you need the count, we advise to only include it in the initial query, and not for subsequent page calls. > - The values passed in the `properties` query parameter can change the response of this API. A fast response on large data sets can be obtained passing any of the following values: `linkTokens`, `ignoreCount`, `ignoreTopics`, `ignoreCustomPreferences`. > - This API is not designed to be used in synchronous workflows. As an alternative, the [Gets preferences for a Data Subject](https://developer.onetrust.com/onetrust/reference/getpreferencesusingget) API can be called. > - It is strongly recommended to pass the `requestContinuation` parameter returned in the response of this API in the next API request to paginate. Including it is crucial for better performance when dealing with multiple pages of data subject records. For more information, see [Understanding & Implementing Pagination](https://developer.onetrust.com/onetrust/reference/understanding-implementing-pagination). > - When specifying a data subject identifier, only the primary identifier is supported. Additional identifiers cannot be used for search or filtering. > 🚧 > > Please note that the FTC Do Not Call List is updated once daily and not updated in real time. As such, there may be a possibility that a consumer's preferences may have changed and they may have opted out of receiving communication before the Do Not Call list gets refreshed. OneTrust is merely conveying information received from the FTC and is not responsible for compiling the lists. - [Get List of Purposes for a Data Subject](https://developer.onetrust.com/onetrust/reference/getdatasubjectpurposesbyidentifierusingget.md): Gets a paged list of Purposes for a Data Subject identifier. We strongly suggest using GET [/datasubjects/profiles](https://developer.onetrust.com/onetrust/reference/getdatasubjectprofileusingget) instead, as this endpoint has been deprecated. - [Deduplicate Data Subjects](https://developer.onetrust.com/onetrust/reference/mergedatasubjectsusingpost.md): Use this API to merge data subject records into a primary data subject record. The transactions and profile history captured across multiple data subject identifiers will be consolidated into the primary data subject record, containing all of the data subject's information. > 🗒 Things to Know > > - Data subjects indicated in the `additionalIdentifiers` parameter value will be deleted after being merged with the `primaryIdentifier`. > - Existing transactions for the `additionalIdentifiers` value will convert to the `primaryIdentifier`. > - Data elements will use the most recent updated value across all of the data subject identifiers. > - Receipts will remain under the data subject identifier from which they were generated. > - Data subjects merged into a single profile will use the magic link of the remaining data subject. > - Merging data subjects may affect the primary data subject's consent status. For more information about transaction and status logic, see [Universal Consent & Preference Management Transaction Types and Purpose Statuses](https://my.onetrust.com/s/article/UUID-d4ed05a9-a999-f2cb-8272-610a5817b43f). - [Delete Scheduled Export](https://developer.onetrust.com/onetrust/reference/deletemergerequestusingdelete.md): Use this API to delete a scheduled export of duplicate data subjects. - [Generate Export of Duplicate Data Subjects](https://developer.onetrust.com/onetrust/reference/exportduplicatedatasubject.md): Use this API to generate an export of duplicate data subjects. Once generated, the Duplicate Data Subjects export will be sent to the user specified in the request as an .xlsx file and can be downloaded from the OneTrust application. > 🗒 Things to Know > > - The [Create Scheduled Export](https://developer.onetrust.com/onetrust/reference/schedulemergerequestusingpost) API can be used to create scheduled exports of duplicate data subjects. > - The [Merge Duplicate Data Subjects](https://developer.onetrust.com/onetrust/reference/mergedatasubjectusingpost) API can be used if data subjects should be merged upon review of the export. - [Get Scheduled Export](https://developer.onetrust.com/onetrust/reference/getmergerequestusingget.md): Use this API to retrieve details of a specific scheduled export of duplicate data subjects. The response will include the associated merge request name, export frequency, and export status. - [Get List of Scheduled Exports](https://developer.onetrust.com/onetrust/reference/getpagedmergerequestusingget.md): Use this API to retrieve a list of all scheduled exports of duplicate data subjects. The response will include the merge request ID along with the associated merge request name, export frequency, and export status. - [Deduplicate Data Subjects](https://developer.onetrust.com/onetrust/reference/mergedatasubjectusingpost.md): Use this API to merge duplicate data subjects in order to consolidate existing Purpose statuses captured across the different identifiers into a single data subject profile. > 🗒 Things to Know > > - The [Create Scheduled Export](https://developer.onetrust.com/onetrust/reference/schedulemergerequestusingpost) API can be used to create scheduled exports of duplicate data subjects. > - The [Generate Export of Duplicate Data Subjects](https://developer.onetrust.com/onetrust/reference/exportduplicatedatasubject) API can be used to generate exports that identify duplicate data subjects. > 👍 > > For more information, see [Merging Data Subjects](https://my.onetrust.com/s/article/UUID-87184a50-16e5-185a-36c2-2ca0b2e18372). - [Create Scheduled Export of Duplicate Data Subjects](https://developer.onetrust.com/onetrust/reference/schedulemergerequestusingpost.md): Use this API to create a scheduled export of duplicate data subjects. > 🗒 Things to Know > > - Once the scheduled export is created, you can retrieve the file using the [Generate Export of Duplicate Data Subjects](https://developer.onetrust.com/onetrust/reference/exportduplicatedatasubject) API. - [Get List of Deletion Certificates](https://developer.onetrust.com/onetrust/reference/getlistofdeletioncertificates.md): Use this API to retrieve a paginated list of deletion certificates. Each result contains information about a data subject or receipts deletion certificate. Supports continuation tokens for pagination. - [Create Job](https://developer.onetrust.com/onetrust/reference/createjobusingpost-1.md): Use this API to create a new schedule job for data subject bulk actions. - [Get Data Subject Token](https://developer.onetrust.com/onetrust/reference/getemaillinktokenbydatasubjectv4.md): Use this API to retrieve the link token for a specific data subject. - [Get List of Data Subject Tokens](https://developer.onetrust.com/onetrust/reference/getemaillinktokenslistv4.md): Use this API to retrieve a list of link tokens created between a specified date range for all data subjects. > 🗒 Things to Know > > - The maximum date range that can be returned is 7 days. - [Get List of Data Subject Tokens](https://developer.onetrust.com/onetrust/reference/getlinktokensusingget.md): Use this API to retrieve a list of link tokens. The response will return link tokens along with the corresponding data subject ID, created date, and expiry date. By default, the response will return link token details sorted in ascending order of created date. - [Get Preference Center Page Schema](https://developer.onetrust.com/onetrust/reference/getpreferencecenterpageschemausingget.md): Use this API to retrieve the schema for a specific page within a Multi Page Preference Center. The response will include the structure of the specified page within the Preference Center, including the sections, Purposes, and Data Elements. - [Get List of Preference Centers](https://developer.onetrust.com/onetrust/reference/getpreferencecentersusingget.md): Use this API to retrieve a list of all Preference Centers. The response will include details for each Preference Center along with the corresponding Preference Center ID, created date, and published date. - [Get Preference Center Root Schema](https://developer.onetrust.com/onetrust/reference/getrootschemausingget.md): Use this API to retrieve the root schema for a Multi Page Preference Center. The response will include the root structure of the Preference Center, including the settings, languages, and configured pages. - [Get Data Subject's Preferences in a Preference Center](https://developer.onetrust.com/onetrust/reference/getdatasubjectpurposesbyidentifierusingget_1.md): Use this API to retrieve a data subject's preferences within a Preference Center. The response will include the list of Purposes that the data subject interacted with in the specified Preference Center along with their current status. - [Get Preference Center Schema](https://developer.onetrust.com/onetrust/reference/getpreferencecenterbyidusingget.md): Use this API to retrieve the schema of a Preference Center. The response will include details about the Preference Center such as settings, languages, and Purposes. > 🗒 Things to Know > > - This API can be used for Original, Enhanced, and Multi Page Preference Centers. - [Update Data Subject's Preferences in a Preference Center](https://developer.onetrust.com/onetrust/reference/updatepreferencesfordatasubjectapiusingput.md): Use this API to update the data subject's preferences within a Preference Center. > 🗒 Things to Know > > - Pascal case is required for all parameters. For example, use `DsDataElements` instead of `dsDataElements`. - [Withdraw Data Subject's Consent for All Purposes in a Preference Center](https://developer.onetrust.com/onetrust/reference/withdrawpreferencesapiusingdelete.md): Use this API to withdraw a data subject's consent for all Purposes within a Preference Center. > 🗒 Things to Know > > - The Notification Opt-Out Purpose will be excluded when calling this API. - [Create Purpose Preference](https://developer.onetrust.com/onetrust/reference/createcustompreferenceusingpost.md): Use this API to create a new Purpose Preference. The Purpose Preference will be created with the details provided in the request body. - [Update Purpose Preference](https://developer.onetrust.com/onetrust/reference/editcustompreferenceusingput.md): Use this API to edit a specific Purpose Preference. The Purpose Preference will be updated with the details provided in the request body. - [Get Purpose Preference](https://developer.onetrust.com/onetrust/reference/findbyguidusingget.md): Use this API to retrieve a single Purpose Preference by its unique identifier along with details such as the Purpose Preference name, languages, number of options, created date, and updated date. - [Get List of Purpose Preferences](https://developer.onetrust.com/onetrust/reference/getlistusingget.md): Use this API to retrieve a list of all Purpose Preferences. The response will include basic details such as the Purpose Preference name, languages, number of options, created date, and updated date. - [Get List of Purpose Versions](https://developer.onetrust.com/onetrust/reference/getgroupedpurposesv2.md): Use this API to retrieve a list of Purpose versions. The response will include details for each Purpose version along with the corresponding Purpose ID, created date, and published date. > 🗒 Things to Know > > - This API returns Purpose descriptions inside `
` and `
`HTML tags. These can be sanitized depending on your formatting needs. - [Get Purpose](https://developer.onetrust.com/onetrust/reference/getpurposedetailusingget.md): Use this API to retrieve a single Purpose by its unique identifier along with the associated attributes, Purpose Preferences, and created date. > 🗒 Things to Know > > - This API returns Purpose descriptions inside `` and `
`HTML tags. These can be sanitized depending on your formatting needs. - [Create New Purpose Version](https://developer.onetrust.com/onetrust/reference/createnewpurposeversionusingpost.md): Use this API to create a new version of an existing Purpose that is currently in **Active** status. A new version of the Purpose will be created in **Draft** status while the **Active** version of the Purpose will remain unchanged. > 🗒 Things to Know > > - Once the Purpose is in **Draft** status, the [Update Purpose](https://developer.onetrust.com/onetrust/reference/editpurposeusingput) API can be used to edit the Purpose. Changes will only be visible once the new version of the Purpose is published. > - This API returns Purpose descriptions inside `` and `
`HTML tags. These can be sanitized depending on your formatting needs. - [Create Purpose](https://developer.onetrust.com/onetrust/reference/createpurposeusingpost.md): Use this this API to create a new Purpose. The new Purpose will be created in **Draft** status and version **1**. > 🗒 Things to Know > > - This API returns Purpose descriptions inside `` and `
`HTML tags. These can be sanitized depending on your formatting needs. - [Update Purpose](https://developer.onetrust.com/onetrust/reference/editpurposeusingput.md): Use this API to update an existing Purpose. Before calling this API, ensure that the Purpose is in **Draft** status. If the Purpose is in **Active** status, use the [Create New Purpose Version](https://developer.onetrust.com/onetrust/reference/createnewpurposeversionusingpost) API to create a new version of the Purpose. > 🗒 Things to Know > > - This API returns Purpose descriptions inside `` and `
`HTML tags. These can be sanitized depending on your formatting needs. - [Get List of Data Subjects by Purpose](https://developer.onetrust.com/onetrust/reference/getdatasubjectsforpurposesusingget.md): Use this API to retrieve a list of data subjects by Purpose. The response will include details for each data subject such as the last transaction date, the transaction status for that Purpose, and Purpose Preferences they have interacted with. > 🗒 Things to Know > > - This API can be used as an alternative to the [Get List of Data Subjects](https://developer.onetrust.com/onetrust/reference/getdatasubjectprofileusingget) API when data subject records for a specific Purpose are required. > - This API returns Purpose descriptions inside `` and `
`HTML tags. These can be sanitized depending on your formatting needs. - [Get List of Purposes](https://developer.onetrust.com/onetrust/reference/getpurposesusingget.md): Gets a paged list of Purposes. We strongly suggest using GET /v2/purposes instead, as this endpoint has been deprecated. - [Publish Purpose](https://developer.onetrust.com/onetrust/reference/publishpurposeusingput.md): Use this API to publish a Purpose. Before calling this API, ensure that the Purpose is in **Draft** status. The Purpose will be published with version **1** and **Active** status. > 🗒 Things to Know > > - The [Update Purpose](https://developer.onetrust.com/onetrust/reference/editpurposeusingput) API can be used to edit an existing Purpose before publishing. > - Once the Purpose is published, the previous version of the Purpose will be set to **Retired** status. > - This API returns Purpose descriptions inside `` and `
`HTML tags. These can be sanitized depending on your formatting needs. - [Retire Purpose](https://developer.onetrust.com/onetrust/reference/setretirementusingput.md): Use this API to set the retirement date for a specific Purpose. > 🗒 Things to Know > > - If the `date` query parameter is left empty, the date will be set to one day in the future by default. > - Data subjects who gave consent to the specified Purpose will be automatically updated after Purpose expiration. A summary of details about this transaction will appear on the Purposes and Receipts tabs of the Data Subject details screen in the OneTrust application for each profile associated to the Purpose. For more information, see [Managing Data Subjects](https://my.onetrust.com/s/article/UUID-3d2d8d5e-e9d7-ac43-4ee1-818a4c4e8932) and [Viewing Consent Receipts & Transactions](https://my.onetrust.com/s/article/UUID-17b03e29-c3b5-c5dc-a172-b2a180f9a826). > - This API returns Purpose descriptions inside `` and `
`HTML tags. These can be sanitized depending on your formatting needs. - [Get List of Receipts](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingpost.md): Use this API to retrieve a list of all receipts. Depending on the query or header parameter values passed in the request, the response will return specific details about receipts, including relevant information about collection point interactions, purposes, and the associated purpose preferences and attributes. > 🗒 Things to Know > > - The timespan between the `fromDate` and `toDate` values must be 24 hours or less. > - By default, this API retrieves receipts created within the last 90 days. To retrieve receipts stored for more than 90 days, the `includeArchived` parameter must be used. > - When retrieving historic receipts, set `includeArchived=true` and provide either the `receiptId` in the request parameters or the `identifier` in the request headers. Optional parameters such as `includeDataElements`, `includeConsentStrings`, `sort`, `page`, and `nextMarker` can also be used. > - If `includeArchived=true` is set and additional parameters such as `fromDate or `toDate` are included, this API will instead search only receipts stored within the last 90 days. > - If the number of records exceeds a single page: > - The response returns a `requestContinuation` value, which must be included in the next request body to continue pagination. > - When retrieving archived receipts, `nextMarker` must also be included in subsequent request bodies to paginate through results. > - Purpose descriptions in the API response are returned inside `` and `
` HTML tags. These tags can be sanitized based on your formatting needs. - [Get Receipt](https://developer.onetrust.com/onetrust/reference/findreceiptusingget.md): > ❗️ End of Support Notification > > As of September 1, 2024, these APIs are now deprecated. Any customers leveraging these APIs are encouraged to migrate to the [Receipts V2 API](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingpost). For more information, see [OneTrust API Sunsetting & Deprecation Guidelines](https://developer.onetrust.com/onetrust/reference/onetrust-api-sunsetting-deprecation-guidelines). Use this API to retrieve a single receipt by its unique identifier. The response will return information such as the receipt interaction date along with details of the Purposes that the data subject has interacted with, and their corresponding statuses. - [Get List of Receipt Details by Data Subject](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingget.md): > ❗️ End of Support Notification > > As of September 1, 2024, these APIs are now deprecated. Any customers leveraging these APIs are encouraged to migrate to the [Receipts V2 API](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingpost). For more information, see [OneTrust API Sunsetting & Deprecation Guidelines](https://developer.onetrust.com/onetrust/reference/onetrust-api-sunsetting-deprecation-guidelines). Use this API to retrieve a list of consent receipts for a given data subject along with details such as the associated Purposes, Purpose Preferences, and attributes. The response will also include relevant information about the latest Collection Point interactions and the current status of consent. - [Get List of Receipts by Data Subject](https://developer.onetrust.com/onetrust/reference/getreceiptlistusingget.md): > ❗️ End of Support Notification > > As of September 1, 2024, these APIs are now deprecated. Any customers leveraging these APIs are encouraged to migrate to the [Receipts V2 API](https://developer.onetrust.com/onetrust/reference/getreceiptlistdetailsusingpost). For more information, see [OneTrust API Sunsetting & Deprecation Guidelines](https://developer.onetrust.com/onetrust/reference/onetrust-api-sunsetting-deprecation-guidelines). Use this API to retrieve a list of consent receipts for a given data subject. - [Get List of Transactions](https://developer.onetrust.com/onetrust/reference/gettransactionsusingpost.md): Use this API to retrieve a list of all consent transactions. The response will include information about each transaction, the corresponding consent date, and details of the Purposes and the associated Purpose Preferences that the data subject has interacted with. > 🗒 Things to Know > > - The timespan for the `fromDate` and `toDate` values must be 24 hours or less. > - The `collectionPointAttributes` parameter will be returned as `null` when left blank during normal ingestion (API collection point, webform) and as `{} ` when left blank during bulk import. - [Withdraw Consent on Behalf of a Data Subject](https://developer.onetrust.com/onetrust/reference/withdrawtransactionbehalfofdatasubjectusingput.md): Use this API to withdraw consent on behalf of a data subject for a specific Purpose. The data subject identifier must be included either in the `identifier` query or header parameter, preferably passed in the header. - [Withdraw Data Subject's Consent](https://developer.onetrust.com/onetrust/reference/withdrawtransactionbypurposeandidentifierusingget.md): Use this API to withdraw a data subject's consent for a specific Purpose. The data subject identifier must be included either in the `identifier` query or header parameter, preferably passed in the header. > 🗒 Things to Know > > - This API is not designed to be used in synchronous workflows. As an alternative, the [Create Consent Receipts ](https://developer.onetrust.com/onetrust/reference/createconsentreceiptusingpost) API can be called. - [Get Catalog Search Results](https://developer.onetrust.com/onetrust/reference/externalsearch.md): Use this API to retrieve a list of all catalog search results by key terms and filters. The response will include relevant details for each result, including the corresponding data asset ID, name, and the associated tags and terms. > 🗒 Things to Know > > - This API returns up to 100,000 catalog search results. For larger volumes, use the [Get Catalog Search Results V2](https://developer.onetrust.com/onetrust/reference/externalsearch-using-continuationtoken) API. - [Get Search Fields](https://developer.onetrust.com/onetrust/reference/get_v1-field-details.md): Use this API to retrieve a list of all catalog search fields. The response will include details such as the search field names, data types, and supported operators. - [Get Catalog Search Results](https://developer.onetrust.com/onetrust/reference/externalsearch-using-continuationtoken.md): Use this API to retrieve a list of all catalog search results by key terms and filters. The response will include relevant details for each result, including the corresponding data asset ID, name, and the associated tags and terms. This API is designed to return large volumes of catalog search results. > 🗒 Things to Know > > - The `continuationToken` parameter returned in the response can be used on a subsequent API call to retrieve the next set of catalog search results. For more information, see [Understanding & Implementing Pagination](https://developer.onetrust.com/onetrust/reference/understanding-implementing-pagination#request-continuation-based-keyset--cursor-based-pagination). - [Get List of Data Asset Attributes](https://developer.onetrust.com/onetrust/reference/getalldataassetattributenames.md): Use this API to retrieve a list of all data asset attributes in the Attribute Manager. - [Get Data Asset Attribute](https://developer.onetrust.com/onetrust/reference/getdataassetattributebyname.md): Use this API to retrieve the details for the specified data asset attribute. - [Delete Multiple Data Asset Tag Associations](https://developer.onetrust.com/onetrust/reference/deletedataassettagassociationsv1-1.md): Use this API to delete multiple tag associations from a specified data asset using its ID. The request should include the asset ID and a list of tags to be removed. The response will confirm the successful removal of associations and return the updated asset ID. - [Delete Multiple Data Asset Term Associations](https://developer.onetrust.com/onetrust/reference/deletedataassettermassociationsv1-1.md): Use this API to delete multiple term associations from a specified data asset using its ID. The request should include the asset ID and a list of terms to be removed. The response will confirm the successful removal of associations and return the updated asset ID. - [Create Tag Associations](https://developer.onetrust.com/onetrust/reference/createdataassettagassociationsv1-1.md): Use this API to create tag associations for the specified data asset. The request should include the data asset ID and the list of tags to assign to the data asset. The response will confirm the successful associations and return the updated data asset ID. - [Create Term Associations](https://developer.onetrust.com/onetrust/reference/createdataassettermassociationsv1-1.md): Use this API to create term associations for the specified data asset. The request should include the data asset ID and the list of terms to assign to the data asset. The response will confirm the successful associations and return the updated data asset ID. - [Create Data Asset](https://developer.onetrust.com/onetrust/reference/createorupsertdataassetv1-1.md): Use this API to create a new data asset or upsert an existing data asset. Data assets must be added using a structured top-down hierarchy to ensure consistent data organization. The request must include all required data asset details, such as the parent ID, name, type, and data source. The response will confirm successful ingestion with the assigned data asset ID. Things to Know - If terms, tags, additional attributes, or users are added to an existing data asset, the system will merge the new values from the request with the existing values. - With the exception of the root (data source) node, every data asset must have its parent record already present in the system before being added. - [Delete Data Asset](https://developer.onetrust.com/onetrust/reference/deletedataassetv1-1.md): Use this API to delete a data asset. The request must include the data asset ID, and the response will confirm acceptance of the deletion request. If the data asset has child objects, those objects will also be deleted asynchronously along with the parent data asset. - [Get Data Asset](https://developer.onetrust.com/onetrust/reference/getdataassetv1-1.md): Use this API to retrieve a specific data asset. The response will include details such as the data source, additional attributes, associated terms, and associated tags. - [Modify Data Asset](https://developer.onetrust.com/onetrust/reference/updatedataassetv1-1.md): Use this API to modify existing data assets while maintaining a structured top-down hierarchy. With this API, the system will replace existing terms, tags, additional attributes, or users with the new data included in the request. The response will confirm the status along with the updated data asset ID. - [Get Glossary](https://developer.onetrust.com/onetrust/reference/getallglossariesbynames.md): Use this API to retrieve the details for the specified business glossary. The response will include details such as the glossary ID, description, and created date. - [Get List of Glossaries](https://developer.onetrust.com/onetrust/reference/getallglossariesnames.md): Use this API to retrieve a list of all business glossaries. - [Create Tag](https://developer.onetrust.com/onetrust/reference/createtagv2.md): Use this API to create a new tag in the Glossary. > 🗒 Things to Know > > - The `type` parameter is case-sensitive. For example, use CATEGORY instead of Category. - [Get Tag](https://developer.onetrust.com/onetrust/reference/gettagdetailswithassociatedterms.md): Use this API to retrieve the details for the specified tag. - [Get List of Tags](https://developer.onetrust.com/onetrust/reference/retrievealltagsname.md): Use this API to retrieve a list of all tag names. - [Create Term](https://developer.onetrust.com/onetrust/reference/createtermusingpost.md): Use this API to create a new term in the Glossary. - [Get List of Term Attributes](https://developer.onetrust.com/onetrust/reference/getalltermattributenames.md): Use this API to retrieve a list of all term attributes created by internal and external systems. - [Get Term Attribute](https://developer.onetrust.com/onetrust/reference/gettermattributebyname.md): Use this API to retrieve the details of a specific term attribute. - [Get List of Terms](https://developer.onetrust.com/onetrust/reference/retrieveallterms.md): Use this API to retrieve a list of all terms or search for a specific term. The response will include details for each term along with the corresponding term ID, name, and glossary to which the term belongs. - [Get Term](https://developer.onetrust.com/onetrust/reference/retrievetermsbyname.md): Use this API to retrieve the details for the specified term. The response will return the term ID, description, and type along with its associated tags. - [Get List of Term Names](https://developer.onetrust.com/onetrust/reference/retrievetermsname.md): Use this API to retrieve a list of all term names. - [Submit Data to Catalog](https://developer.onetrust.com/onetrust/reference/catalogdatausingpost.md): Use this API to submit metadata for cataloging for a given custom connector scan job. - [Submit Data to Classify](https://developer.onetrust.com/onetrust/reference/classifydatausingpost.md): Use this API to submit content for classification for a given custom connecter scan job. - [Get List of Scan Jobs](https://developer.onetrust.com/onetrust/reference/geteligiblejobsusingget.md): Use this API to get details of any pending custom connecter scan jobs for the specified data source. - [Update Scan Job Status](https://developer.onetrust.com/onetrust/reference/updatejobstatususingput.md): Use this API to update the custom connecter scan job's status. - [Create Custom Classifier](https://developer.onetrust.com/onetrust/reference/createdetector.md): Use this API to create a custom classifier. - [Delete Custom Classifier](https://developer.onetrust.com/onetrust/reference/deletedetector.md): Use this API to delete a custom classifier. - [Get Custom Classifier](https://developer.onetrust.com/onetrust/reference/getdetectorbyclassifiername.md): Use this API to retrieve a specific custom classifier. The response will include details such as the detector type, detection rules, last modified date, and created date. - [Get List of Custom Classifiers](https://developer.onetrust.com/onetrust/reference/listdetectors.md): Use this API to retrieve a list of all custom classifiers. The response will include details such as the classifier name, ID, and detector type. - [Update Custom Classifier](https://developer.onetrust.com/onetrust/reference/updatedetector.md): Use this API to update an existing custom classifier. - [Create Credential](https://developer.onetrust.com/onetrust/reference/createcredential.md): Use this API to create a new credential. - [Delete Credential](https://developer.onetrust.com/onetrust/reference/deletecredential.md): Use this API to delete an existing credential and its associated reference keys. - [Get Credential](https://developer.onetrust.com/onetrust/reference/getcredentialbyid.md): Use this API to retrieve a single credential by its unique identifier. - [Get List of Credentials](https://developer.onetrust.com/onetrust/reference/getcredentials.md): Use this API to retrieve a list of all credentials. The response will include details such as the credential name, ID, and reference key. - [Update Credential](https://developer.onetrust.com/onetrust/reference/updatecredential.md): Use this API to update an existing credential. - [Delete Data Source](https://developer.onetrust.com/onetrust/reference/deletesystemusingdelete_1.md): Use this API to delete an existing data source and its associated scan results. - [Get List of Data Sources](https://developer.onetrust.com/onetrust/reference/getallusingget_1.md): Use this API to retrieve a list of data sources in JSON format. The response will include details for each data source along with the corresponding data source ID, system name, and associated settings. - [Get Data Source](https://developer.onetrust.com/onetrust/reference/getdatasourcebyidusingget_1.md): Use this API to retrieve a single data source in JSON format by its unique identifier. - [Create or Update Data Source](https://developer.onetrust.com/onetrust/reference/upsertsourcesystemv3usingput.md): Use this API to create a new data source or update an existing data source. The data source will be created or updated with the details provided in the request body. - [Get List of Image tags](https://developer.onetrust.com/onetrust/reference/getdockerrepositorytagsusingget.md): Use this API to retrieve a list of all Docker images for a specific worker node version. > 🗒 Things to Know > > - The list of Docker images will be returned in the following format: [REPOSITORY[ : TAG]], where tag stands for version number. - [Cancel Scan Job](https://developer.onetrust.com/onetrust/reference/canceljobusingpatch.md): Use this API to cancel an existing scan job by its unique identifier. The job must be in a cancellable state (PENDING, PROCESSING, PAUSING). Jobs that are already COMPLETED, FAILED, CANCELLED, or CANCELLING cannot be cancelled. The cancellation is asynchronous - the job status will change to CANCELLING immediately, then to CANCELLED once the worker node acknowledges the cancellation. - [Cancel Scan Job](https://developer.onetrust.com/onetrust/reference/cancelscanjob.md): Use this API to cancel an existing scan job by its unique identifier. - [Create Scan Job](https://developer.onetrust.com/onetrust/reference/createjobusingpost.md): Use this API to create a new scan job in the specified data source. - [Get Scan Job](https://developer.onetrust.com/onetrust/reference/getjobbyidusingget.md): Use this API to retrieve details of a specific scan job by its unique identifier. Returns comprehensive job information including status, progress, timestamps, metadata counts, scan profile used, and ingestion status. - [Get Scan Job](https://developer.onetrust.com/onetrust/reference/getjobusingget_1.md): Use this API to retrieve a single scan job in JSON format by its unique identifier. - [Get List of Scan Jobs](https://developer.onetrust.com/onetrust/reference/getscanjobsbydatasourceusingget_1.md): Use this API to retrieve a list of all scan jobs in JSON format for the specified data source. The response will include relevant details for each scan job, including the corresponding scan job ID, created date, and cancelled date. - [Create Scan Profile](https://developer.onetrust.com/onetrust/reference/createv2usingpost.md): Use this API to create a new scan profile. - [Delete Scan Profile](https://developer.onetrust.com/onetrust/reference/deletescanprofileusingdelete_1.md): Use this API to delete an existing scan profile. - [Get List of Scan Profiles](https://developer.onetrust.com/onetrust/reference/getallusingget_2.md): Use this API to retrieve a list of all scan profiles. The response will include details for each scan profile along with the corresponding scan profile ID and its associated scan type, system, and paths. - [Get Scan Profile](https://developer.onetrust.com/onetrust/reference/getscanprofileusingget_1.md): Use this API to retrieve a single scan profile by its unique identifier along with the associated scan type, system, and paths. - [Update Scan Profile](https://developer.onetrust.com/onetrust/reference/updatev2usingput.md): Use this API to update an existing scan profile. - [Create Emission Factor](https://developer.onetrust.com/onetrust/reference/addemissionfactor.md): Use this API to create emission factor. ### Example Request `POST https://{hostname}/api/esg-management/v1/entity-types/names/emission-factors/entities` `POST https://trial.onetrust.com/api/esg-management/v1/entity-types/names/emission-factors/entities` - [Create Emission Transaction](https://developer.onetrust.com/onetrust/reference/addemissiontransaction.md): Use this API to create emission transaction. ### Additional Information * Emission Factors names and id list can be obtained using the [Retrieve Emission Factors list](/onetrust/reference/getAllEmissionFactorsBasicEntityDetails) API. Use the required id to fill the emissionFactorId field in entityDetail. ### Example Request `POST https://{hostname}/api/esg-management/v1/entity-types/names/emission-transactions/entities` `POST https://trial.onetrust.com/api/esg-management/v1/entity-types/names/emission-transactions/entities` - [Get List of Emission Details](https://developer.onetrust.com/onetrust/reference/findallbytypeandcriteria.md): Use this API to get list of Emission Details by Criteria. ### Additional Information * Filtering can be added in the request body. ### Example Request `POST https://{hostname}/api/esg-management/v1/entity-types/names/{entityTypeName}/entities/pages` `POST https://trial.onetrust.com/api/esg-management/v1/entity-types/names/{entityTypeName}/entities/pages` - [Get List of Emission Factors](https://developer.onetrust.com/onetrust/reference/getallemissionfactorsbasicentitydetails.md): Use this API to get list of emission factors. ### Example Request `GET https://{hostname}/api/esg-management/v1/emission-factors` `GET https://trial.onetrust.com/api/esg-management/v1/emission-factors` - [Get Metric Details](https://developer.onetrust.com/onetrust/reference/fetchmetricsdetails.md): Retrieve the latest details of ESG metrics based on Reporting Period. ### Example Request `POST https://{hostname}/api/esg-management/v1/metrics/metric-details` `POST https://trial.onetrust.com/api/esg-management/v1/metrics/metric-details` Below are the examples of request body to retrieve Metric Details. ```json Example 1 { "startDate": "2019-01-01", "endDate": "2019-12-31" } ``` ```json Example 2 { "allTimeOption": "ESG.Metric.MetricData.AllTimeReportingPeriodOption" } ``` - [LLMs.txt: AI Integration Guide](https://developer.onetrust.com/onetrust/reference/llmstxt-ai-integration-guide.md) - [Connect to the MCP Server (Model Context Protocol)](https://developer.onetrust.com/onetrust/reference/mcp.md) - [OAuth 2.0 Scopes](https://developer.onetrust.com/onetrust/reference/oauth-20-scopes.md) - [OneTrust API Reference](https://developer.onetrust.com/onetrust/reference/onetrust-api-reference.md) - [Quick Start Guide: APIs](https://developer.onetrust.com/onetrust/reference/quick-start-guide.md) - [URL Variables for APIs & SDKs](https://developer.onetrust.com/onetrust/reference/url-variables-for-apis-sdks.md) - [Get Audit Records for Login History](https://developer.onetrust.com/onetrust/reference/loginhistory.md): Use this API to retrieve the login history of all users or a specific user for audit purposes. > 🗒 Things to Know > > - If a date range and specific `userId` is not specified in the request, the response will include the login history for all users over the past 7 days. > - If a date range is not specified but a specific `userId` is specified in the request, the response will include the login history for that specific user over the past 365 days. > - If a date range is specified but a specific `userId` is not specified in the request, the response will include the login history for all users over the specified date range. > - If the date range does not fall within the last 365 days, the response will return an error. - [Get Audit Records for User's Profile](https://developer.onetrust.com/onetrust/reference/useractivity.md): Use this API to retrieve a list of changes made to a user's profile for audit purposes. The response will include a history of changes made to the user's details, roles, and organizations. - [Generate Access Token](https://developer.onetrust.com/onetrust/reference/getoauthtoken-1.md): Use this API to generate an OAuth access token using the `client_credentials` grant type. > 🗒 Things to Know > > - Client credentials can be generated from within Global Settings in the OneTrust application. For more information, see [Managing OAuth 2.0 Client Credentials](/onetrust/docs/managing-oauth-20-client-credentials). > - Use the `client_id` and `client_secret` to generate the OAuth access token using this API. > - A maximum of 500 OAuth 2.0 client credentials can be created per account. - [Create Organization](https://developer.onetrust.com/onetrust/reference/createorganizationusingpost.md): Use this API to create an organization within the organizational hierarchy. > 🗒 Things to Know > > - The organization will be created as a child of the organization specified in the `parentExternalId` parameter. If a `parentExternalId`value is not specified in the request, the organization will be created as a child of the root organization. - [Delete Organization](https://developer.onetrust.com/onetrust/reference/deleteorganizationpost.md): Use this API to delete an existing organization and move its associated objects to a different organization. - [Get List of Organizations](https://developer.onetrust.com/onetrust/reference/organizationtreestructureusingget.md): Use this API to retrieve a list of all organizations within the organizational hierarchy. - [Update Organization](https://developer.onetrust.com/onetrust/reference/updateorganizationusingput.md): Use this API to update the details of an existing organization within the organizational hierarchy. - [Add User Group Roles](https://developer.onetrust.com/onetrust/reference/addaccesslevelsforusergroupbyidv2.md): Use this API to add a new role to a user group. - [Add User to User Group](https://developer.onetrust.com/onetrust/reference/addamemberforusergroupbyidv2.md): Use this API to add a single user to a specified user group. - [Add Multiple Users to User Group](https://developer.onetrust.com/onetrust/reference/addmultiplemembersforusergroupbyidv2.md): Use this API to add multiple users to a specified user group in bulk. - [Create User Group](https://developer.onetrust.com/onetrust/reference/createusergroupv2.md): Use this API to create a new user group with a specified name and description. - [Delete User Group](https://developer.onetrust.com/onetrust/reference/deleteusergroupbyidv2.md): Use this API to delete an existing user group by its unique identifier. - [Get User Group Roles](https://developer.onetrust.com/onetrust/reference/getaccesslevelsforusergroupbyidv2.md): Use this API to retrieve a list of roles for a specific user group. - [Get List of User Groups](https://developer.onetrust.com/onetrust/reference/getallusergroupwithfiltersv2.md): Use this API to retrieve a list of user groups, with support for pagination and filtering. - [Get List of Users in User Group](https://developer.onetrust.com/onetrust/reference/getmembersfromausergroupbyidv2.md): Use this API to retrieve a paginated list of members in a specified user group. - [Get User Group](https://developer.onetrust.com/onetrust/reference/getusergroupbyidv2.md): Use this API to retrieve a specific user group by its unique identifier. - [Remove User Group Roles](https://developer.onetrust.com/onetrust/reference/removeaccesslevelforusergroupbyidv2.md): Use this API to remove roles from a specific user group. - [Remove User from User Group](https://developer.onetrust.com/onetrust/reference/removeamemberforusergroupbyidv2.md): Use this API to remove a single user from a specified user group. - [Remove Multiple Users from User Group](https://developer.onetrust.com/onetrust/reference/removemultiplemembersforusergroupbyidv2.md): Use this API to remove multiple users from a specified user group in bulk. - [Update User Group Roles](https://developer.onetrust.com/onetrust/reference/updateaccesslevelforusergroupbyidv2.md): Use this API to update the roles of a user group by replacing the current set of roles with a new one. - [Update User Group](https://developer.onetrust.com/onetrust/reference/updateusergroupbyidv2.md): Use this API to update the attributes of an existing user group by its unique identifier. - [Add Members to User Group](https://developer.onetrust.com/onetrust/reference/addmembersusingpost.md): Use this API to add users as members of a specific user group. > 🗒 Things to Know > > - When a user is added as a member of a user group, the user inherits the role and organization configured for that user group. If the user belongs to other user groups, the user will still retain existing membership with those groups in addition to their other existing roles and permissions. > - The `userId` of the users to be added to the user group can be specified in the request body in a comma separated list. - [Create User Group](https://developer.onetrust.com/onetrust/reference/createusergroupusingpost.md): Use this API to create a new user group. - [Delete User Group](https://developer.onetrust.com/onetrust/reference/deleteusergroupusingdelete.md): Use this API to delete an existing user group. - [Remove Members from User Group](https://developer.onetrust.com/onetrust/reference/removemembersusingdelete.md): Use this API to remove users as members of a specific user group. > 🗒 Things to Know > > - The `userId` of the users to be removed from the user group can be specified in the request body in a comma separated list. - [Get User Group Members](https://developer.onetrust.com/onetrust/reference/retrievemembersusingget.md): Use this API to retrieve a list of users that are members of a specific user group. - [Get List of User Groups](https://developer.onetrust.com/onetrust/reference/retrieveusergroupsusingget.md): Use this API to retrieve a list of user groups. - [Update User Group](https://developer.onetrust.com/onetrust/reference/updateusergroupusingput.md): Use this API to update the name and description of a specific user group. - [Add User Role](https://developer.onetrust.com/onetrust/reference/adduseraccesslevelv2.md): Use this API to add a new role to a specific user. - [Create User](https://developer.onetrust.com/onetrust/reference/createuserv2.md): Use this API to create a new user in your account. - [Get List of Users](https://developer.onetrust.com/onetrust/reference/getalluserdetailsv2.md): Use this API to retrieve a list of all users in your account. - [Get User Roles](https://developer.onetrust.com/onetrust/reference/getuseraccesslevelsv2.md): Use this API to retrieve a list of roles assigned to a specific user. - [Get User](https://developer.onetrust.com/onetrust/reference/getuserv2.md): Use this API to retrieve details for a single user in your account. - [Remove User Role](https://developer.onetrust.com/onetrust/reference/removeuseraccesslevelv2.md): Use this API to remove a specific role from a user. - [Modify User Default Organization](https://developer.onetrust.com/onetrust/reference/setuserdefaultorganizationv2.md): Use this API to modify the default organization for a specific user. The user must have at least one role in the specified organization. - [Update User](https://developer.onetrust.com/onetrust/reference/updateuserv2.md): Use this API to update the details for a single user in your account. - [Cancel Bulk Export](https://developer.onetrust.com/onetrust/reference/cancelbulkexportdelete.md): Use this API to cancel a bulk export that has not been completed. - [Get Bulk Export Download Details](https://developer.onetrust.com/onetrust/reference/getattachmentdownloadcommandsget.md): Use this API to retrieve the download details for a bulk export. The response will include the authorization token (expires after 1 hour), file name, and URL that you can include within the following cURL command to download the export files: ```curl curl --header "Authorization: Bearer