---
title: "Get List of Data Subject Group Associations by Data Subject"
method: GET
path: "/rest/api/consent/v4/linkedidentitygroups"
tags: ["Data Subject Groups V4"]
---

# Get List of Data Subject Group Associations by Data Subject

`GET /rest/api/consent/v4/linkedidentitygroups`

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.

## Query parameters

- `linkedIdentityGroupId` string, uuid

## Headers

- `identifier` string, required

## Response `200`

OK

- ConsentAPILinkedIdentityGroupDto[]
  - `id` string — The unique identifier of the data subject group.
  - `name` string — The name of the data subject group.
  - `identifier` string — The data subject identifier of the data subject.
  - `isPrimary` boolean — This flag indicates whether the data subject identifier is the primary identifier associated with the data subject group.
  - `addedDate` string, date-time — The date and time that the data subject was added to the data subject group.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)