Get List of Data Subjects

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 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.
  • 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.

Query Params
date-time

Restrict information to changes in consent information since a given date: formats accepted yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss. Note that the since and updatedSince parameters cannot be used in conjunction.

date-time

Filter Data Subjects records that were last updated before the specified date: formats accepted yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss. Note that the since and updatedTo parameters cannot be used in conjunction.

date-time

Filter Data Subject records that were last updated after the specified date: formats accepted yyyy-MM-dd or yyyy-MM-ddTHH:mm:ss. Note that the since and updatedSince parameters cannot be used in conjunction.

string
deprecated

Data subject identifier to filter results.

uuid

Restrict information to only DataSubjects related to a purpose.

uuid

Restrict information to only DataSubjects related to a collection point id.

string

Restrict information to only DataSubjects related to a collection point name.

string

Specify optional properties, any of: [linkTokens] return linkTokens, [ignoreCount] will not return a full record count, [ignoreTopics] will exclude Topics from Purposes, [ignoreCustomPreferences] will exclude Custom Preferences from Purposes. This is the preferred option for a fast response on large datasets, [includeAllPreferences] will include for all Topics and CustomPreferenceOptions attached to Purposes a boolean value specifying whether the Topic/CustomPreferenceOption has been consented to or not, [includeNotices] will include the privacy notices the data subject has consented to in each profile, eg: properties=linkTokens,ignoreCustomPreferences,includeAllPreferences

boolean

Include effective status of Data Subject Profiles (true/false).

uuid

Unique identifier identifying a Linked Identity Group.

boolean

Include consent attachments of DataSubject (true/false).

boolean

Include DNC records (true/false).

boolean

Include data subjects with no organization (true/false).

boolean

Include Geolocation parameters of the DataSubject (true/false).

integer
≥ 0
Defaults to 0

Results page you want to retrieve (0..N).

integer
1 to 50
Defaults to 20

Number of records per page.

string
enum
Defaults to lastModifiedDate,desc

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Headers
string

Restrict information to one DataSubject.

string

Filter Data Subject records with Data Element name. Note that it must be used in conjunction with dataElementValue.

string

Filter Data Subject records with Data Element value. Note that it must be used in conjunction with dataElementName.

string

The token used to paginate a response if the number of records is more than a page.

Responses

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal Server Error

Language
Credentials
OAuth2
Missing 2 required scopes
URL
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*