v1

latestOpenAPI 3.1.0Apache 2.02026-07-245981,1853.0 MB

Consent Groups

Get Consent Group

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.

get/api/consent/v2/consent-groups/{consentGroupGuid}

Path parameters

consentGroupGuidstring uuid required

Example:823e4567-e89b-12d3-a456-fa6614171652

The UUID of the Consent Group. consentGroupGuid can be retrieved using the Get a paged view for consent groups API

Response

Successfully retrieved Consent Group.

namestring

The Consent Group name

descriptionstring

A description of the Consent Group

externalNamestring

The Consent Group's external name. If not provided, this will be generated based on the name

consentGroupIdstring uuid

Unique identifier identifying a Consent Group

membershipType'EMPTY' | 'CHILD_GROUPS' | 'DATA_SUBJECTS'

Indicates whether the consent group has other consent groups as its children, or if it has data subjects associated to it

Example response

{
  "name": "OneTrust Atlanta",
  "description": "Consent for the company OneTrust, specifically for the Atlanta Office. Contains subsidiary data subjects representing OneTrust employees that work at this location.",
  "externalName": "onetrust_atlanta",
  "consentGroupId": "2a644966-fe93-4561-b71a-f0dda4396459",
  "membershipType": "CHILD_GROUPS",
  "purposeRules": [
    {
      "purposeId": "f2229953-b4b5-4042-8cb9-b78038cc4c46",
      "enforcedStatus": "ACTIVE",
      "effectiveStatus": "OPT_OUT"
    }
  ],
  "dataSubjects": [
    {
      "id": "633ba071-61b0-485f-81a0-a2245777b432",
      "identifier": "example@otprivacy.com",
      "purposes": [
        {
          "id": "f2229953-b4b5-4042-8cb9-b78038cc4c46",
          "version": 2,
          "status": "ACTIVE",
          "effectiveStatus": "OPT_OUT"
        }
      ]
    }
  ],
  "consentGroups": [
    {
      "name": "OneTrust Atlanta",
      "description": "Consent for the company OneTrust, specifically for the Atlanta Office. Contains subsidiary data subjects representing OneTrust employees that work at this location.",
      "externalName": "onetrust_atlanta",
      "consentGroupId": "2a644966-fe93-4561-b71a-f0dda4396459",
      "membershipType": "CHILD_GROUPS"
    }
  ]
}