---
title: "Get List of Transactions"
method: POST
path: "/api/consent/v2/transactions"
tags: ["Transactions V2"]
---

# Get List of Transactions

`POST /api/consent/v2/transactions`

Use this API to retrieve a list of all consent transactions. The response will include information about each transaction, the corresponding consent date, and details of the Purposes and the associated Purpose Preferences that the data subject has interacted with.

> 🗒 Things to Know
> 
> - The timespan for the `fromDate` and `toDate` values must be 24 hours or less.
> - The `collectionPointAttributes` parameter will be returned as `null` when left blank during normal ingestion (API collection point, webform) and as `{} ` when left blank during bulk import.

## Query parameters

- `fromDate` string, date-time
- `toDate` string, date-time
- `collectionPointGuid` string, uuid
- `page` integer
- `size` integer
- `sort` 'consentCreationDate,asc' | 'consentCreationDate,desc'

## Request body

- ConsentAPIContinuationToken
  - `requestContinuation` string — Request continuation token used to paginate. If the number of records in the response is more than a page, it returns a `requestContinuation` token in the response. This `requestContinuation` token should be passed to the next request's body to paginate.
  - `nextMarker` string — Request continuation token used to paginate over historical receipts

## Response `200`

Successfully retrieved list of transactions

- ConsentAPITransactionSliceDto
  - `content` ConsentAPITransactionDto[]
    - `receiptId` string — The unique identifier identifying the Receipt
    - `collectionPointUUID` string, uuid — Unique Identifier identifying a Collection Point
    - `identifier` string — Unique Identifier identifying a Data Subject
    - `consentCreationDate` string, date-time — The Date the Data Subject consented
    - `interactionDate` string, date-time — The date and time that the data subject data subject consent was interacted.
    - `collectionPointAttributes` object
    - `transactionGuid` string, uuid — The unique identifier for the transaction.
    - `guid` string, uuid — The unique identifier for purpose.
    - `purposeGuid` string, uuid — The unique identifier for purpose.
    - `purposeVersion` integer — The version of the purpose.
    - `expiryDate` string, date-time — The Date by which the consent will expire.
    - `removeExpiry` boolean — Whether the purpose's expiry can be removed
    - `topics` ConsentAPIPreferenceDto[] — The topics tied to the transaction.
      - `topicId` string, uuid — Unique Identifier identifying a Topic
      - `transactionType` string — Transaction type for the topic
    - `customPreferences` ConsentAPICustomPreferenceDto[] — List of CustomPreferences for the purpose
      - `id` string, uuid — The unique identifier of the custom preference.
      - `options` string[] — List of options linked to this preference.
      - `choices` ConsentAPICustomPreferenceChoiceDto[] — List of choices made for this custom preference.
        - `optionId` string, uuid — The identifier of the selected option for this preference.
        - `transactionType` string — The type of transaction associated with this option.
    - `transactionType` 'PENDING' | 'CONFIRMED' | 'WITHDRAWN' | 'EXPIRED' | 'NOTGIVEN' | 'OPT_OUT' | 'NO_CHOICE' | 'HARD_OPT_OUT' | 'EXTEND' | 'CHANGE_PREFERENCES' | 'CANCEL' | 'NO_OPT_OUT' | 'OPT_IN' | 'IMPLICIT' — The transaction type.
    - `attributes` object — The attributes attached to the purpose.
    - `purposeNote` ConsentAPIPurposeNoteDto
      - `noteId` string, uuid — Unique identifier for the purpose note
      - `noteType` 'UNSUBSCRIBE_REASON' — Type of the note
      - `noteLanguage` string — Language of the purpose note
      - `noteText` string — The actual text of the note
    - `autoGenerated` boolean
    - `purposeAttachments` ConsentAPIAttachmentDto[] — The attachment guids tied to the purpose
      - `id` string, uuid — The unique identifier of the uploaded attachment.
    - `consentDate` string, date-time — The date and time when the consent was given by the data subject.
    - `issueDate` string, date-time — The date and time when the consent receipt was issued.
    - `withdrawalDate` string, date-time — The date and time when the consent was withdrawn, if applicable.
    - `activationDate` string, date-time — The date and time when the consent became active.
    - `createdBy` string — The guid of the user or system that created the consent record.
    - `withdrawnBy` string — The guid of the user or system that withdrew the consent, if applicable.
    - `doubleOptIn` boolean — Indicates whether the consent requires Double Opt-In confirmation.
    - `test` boolean — Indicates whether the data subject is marked as a test record.
    - `purposePrivacyNotices` ConsentAPIPrivacyNoticeDto[] — List of privacy notices associated with the purposes of this consent.
      - `id` string, uuid — The unique identifier of the privacy notice.
      - `version` integer — The major version number of the privacy notice.
      - `minorVersion` integer — The minor version number of the privacy notice.
    - `collectionPointPrivacyNotices` ConsentAPIPrivacyNoticeDto[] — List of privacy notices associated with the collection point where the consent was captured.
      - `id` string, uuid — The unique identifier of the privacy notice.
      - `version` integer — The major version number of the privacy notice.
      - `minorVersion` integer — The minor version number of the privacy notice.
    - `purposeScopes` ConsentAPIPurposeScopeDto[] — The specific scope of purposes for which the consent applies.
      - `key` string — The key representing a specific scope of the purpose.
      - `value` string — The description of the purpose scope.
  - `pageable` ConsentAPIPageableObjectWithContinuationToken
    - `paged` boolean
    - `pageNumber` integer
    - `offset` integer
    - `pageSize` integer
    - `unpaged` boolean
    - `sort` ConsentAPISortObject
      - `empty` boolean
      - `sorted` boolean
      - `unsorted` boolean
    - `requestContinuation` string — The token used to paginate a response if the number of records is more than a page.
  - `first` boolean
  - `last` boolean — Flag indicating whether this is the last page or not.
  - `number` integer — The page number of the results.
  - `sort` ConsentAPISortObject
    - `empty` boolean
    - `sorted` boolean
    - `unsorted` boolean
  - `size` integer — The number of results per page.
  - `numberOfElements` integer
  - `empty` boolean

## 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)