---
title: "Get List of Data Subject Tokens"
method: GET
path: "/api/consentmanager/v1/linktokens"
tags: ["Magic Link Tokens"]
---

# Get List of Data Subject Tokens

`GET /api/consentmanager/v1/linktokens`

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.

## Query parameters

- `since` string, date-time
- `until` string, date-time
- `page` integer
- `size` integer
- `sort` 'id,asc' | 'id,desc' | 'tokenId,asc' | 'tokenId,desc' | 'expiryDate,asc' | 'expiryDate,desc' | 'createdDate,asc' | 'createdDate,desc' | 'lastModifiedDate,asc' | 'lastModifiedDate,desc' | 'createdBy,asc' | 'createdBy,desc' | 'lastModifiedBy,asc' | 'lastModifiedBy,desc' | 'dataSubject.guid,asc' | 'dataSubject.guid,desc' | 'dataSubject.identifier,asc' | 'dataSubject.identifier,desc'

## Headers

- `identifier` string

## Response `200`

OK - Successfully retrieved link tokens.

- ConsentPreferencesUniversalConsentPreferenceManagPageLinkTokenDto
  - `content` ConsentPreferencesUniversalConsentPreferenceManagLinkTokenDto[] — The list of items for the current page.
    - `DataSubjectId` string, required — The unique identifier of the Data Subject (e.g., email address)
    - `LinkToken` string, required — The secure token used to authenticate the Data Subject in the Preference Center
    - `UrlEncodedLinkToken` string — URL-encoded version of the link token for use in URLs
    - `ExpiryDate` string, date-time — The date and time when the link token will expire
    - `CreatedDate` string, date-time — The date and time when the link token was created
  - `empty` boolean — The flag to check if the entity is empty or not.
  - `first` boolean — The flag to check if the entity is first entity or not.
  - `last` boolean — The flag to check if the entity is last entity or not.
  - `number` integer — The number associated with the result.
  - `numberOfElements` integer — Total number of elements in the result.
  - `pageable` ConsentPreferencesUniversalConsentPreferenceManagPageableObject
    - `offset` integer
    - `sort` ConsentPreferencesUniversalConsentPreferenceManagSortObject
      - `empty` boolean
      - `unsorted` boolean
      - `sorted` boolean
    - `pageNumber` integer
    - `pageSize` integer
    - `paged` boolean
    - `unpaged` boolean
  - `sort` ConsentPreferencesUniversalConsentPreferenceManagSortObject
    - `empty` boolean
    - `unsorted` boolean
    - `sorted` boolean
  - `totalPages` integer — Total number of pages in the result list.
  - `totalElements` integer — Total number of elements in the result.
  - `size` integer — Size of the result list.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `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/revisions/21de3aa0b170/schema)