Our latest Data Subjects highly available APIs focus on improving Data Subjects APIs by offering more targeted queries to increase efficiency by providing faster response times. The examples below show the new V4 endpoints and their equivalent versions. In addition, the required parameters for transitioning to the new version are provided along with the differences that the new endpoints present.
For more information, click API titles to navigate to the corresponding V4 endpoint.
Required Parameters
identifier
Equivalents
curl --request GET \
--url 'https://customer.my.onetrust.com/api/consentmanager/v1/datasubjects/profiles?size=20' \
--header 'accept: application/json' \
--header 'identifier: <IDENTIFIER>'
curl --request GET \
--url https://customer.my.onetrust.com/api/consentmanager/v2/datasubjects \
--header 'accept: application/json' \
--header 'identifier: IDENTIFIER'
url --request GET \
--url https://customer.my.onetrust.com/rest/api/preferences/v3/datasubjects/profile \
--header 'accept: application/json' \
--header 'identifier: IDENTIFIER'
What's new
In V4, this API provides the data subject details at the identity level (i.e., no consent level information), minimizing the data parsing process and improving performance speed.
Required Parameters
identifier
Equivalents
curl --request GET \
--url 'https://customer.my.onetrust.com/api/consentmanager/v1/datasubjects/profiles?size=20' \
--header 'accept: application/json' \
--header 'identifier: <IDENTIFIER>'
curl --request GET \
--url https://customer.my.onetrust.com/api/consentmanager/v2/datasubjects \
--header 'accept: application/json'
url --request GET \
--url https://customer.my.onetrust.com/rest/api/preferences/v3/datasubjects/profile \
--header 'accept: application/json' \
--header 'identifier: IDENTIFIER'
What's new
In V4, this API expands on the basic details of a data subject and can be used to retrieve more details of a data subject, including purpose information.
Required Parameters
None
Equivalents
curl --request GET \
--url https://customer.my.onetrust.com/api/consentmanager/v1/datasubjects/profiles \
--header 'accept: application/json'
curl --request GET \
--url https://customer.my.onetrust.com/api/consentmanager/v2/datasubjects \
--header 'accept: application/json'
curl --request GET \
--url https://customer.my.onetrust.com/rest/api/preferences/v3/datasubject-profiles \
--header 'accept: application/json'
Required Parameters
identifier
purposeGuid
Equivalents
curl --request GET \
--url 'https://customer.my.onetrust.com/api/consentmanager/v1/datasubjects/profiles?size=20' \
--header 'accept: application/json' \
--header 'identifier: <IDENTIFIER>'
Not applicable
url --request GET \
--url https://customer.my.onetrust.com/rest/api/preferences/v3/datasubjects/profile \
--header 'accept: application/json' \
--header 'identifier: IDENTIFIER'
What's new
This V4 API allows you to retrieve specific purpose information for a data subject.
Required Parameters
identifier
Equivalents
curl --request GET \
--url 'https://customer.my.onetrust.com/api/consentmanager/v1/datasubjects/profiles?size=20' \
--header 'accept: application/json' \
--header 'identifier: <IDENTIFIER>'
curl --request GET \
--url https://customer.my.onetrust.com/api/consentmanager/v2/datasubjects \
--header 'accept: application/json' \
--header 'identifier: IDENTIFIER'
url --request GET \
--url https://customer.my.onetrust.com/rest/api/preferences/v3/datasubjects/profile \
--header 'accept: application/json' \
--header 'identifier: IDENTIFIER'
What's new
This V4 API is most similar to what V1 and V3 do, returning all purpose information for a given data subject.
Required Parameters
updatedSince
updatedUntil
Equivalents
Not applicable
Not applicable
Not applicable
What's new
This new V4 API allows you to extract purpose details by last collection point, purpose and/or status. This cannot be achieved using the V1 or V3 endpoints.
Required Parameters
identifier
Equivalents
curl --request GET \
--url 'https://customer.my.onetrust.com/api/consentmanager/v1/linktokens?page=0&size=20' \
--header 'accept: application/json' \
--header 'identifier: IDENTIFIER'
Not applicable
Not applicable
What's new
This API allows you to retrieve the link token for a specific data subject.
Required Parameters
fromDate
toDate
Equivalents
curl --request GET \
--url 'https://customer.my.onetrust.com/api/consentmanager/v1/linktokens?page=0&size=20' \
--header 'accept: application/json' \
Not applicable
Not applicable
What's new
This V4 API allows you to retrieve all link tokens. You must use requestContinuation
token for pagination.
Required Parameters
identifier
Equivalents
Not applicable
curl --request GET \
--url 'https://customer.my.onetrust.com/api/consentmanager/v2/linkedidentitygroups?page=0&size=20' \
--header 'accept: application/json' \
--header 'primaryDataSubjectIdentifier: IDENTIFIER'
Not applicable
Required Parameters
linkedIdentityGroupId