---
title: "Get end-user consent status"
method: GET
path: "/consent/v3/history/{siteId}"
tags: ["GDPR TCF end-user consent status"]
---

# Get end-user consent status

`GET /consent/v3/history/{siteId}`

## Request

- Base URL: `https://cdn.privacy-mgmt.com/consent/tcfv2`
- URL: `https://cdn.privacy-mgmt.com/consent/tcfv2/consent/v3/history/{siteId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/privacy-mgmt/apis/sourcepoint-gdpr-tcf-api/docs/consent/v3/history/:siteId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns end-user GDPR TCF consent status for a property. In addition to the `siteId`, you will also need to include <u>either</u> the end-user's `consentUUID` or `authId`.

## Path parameters

- `siteId` integer, required

## Query parameters

- `consentUUID` string
- `authId` string
- `latest` boolean

## Response `200`

Success

- object[]: Returned response to get consent request
  - `_id` string: Unique identifier for the consent record
  - `siteId` number: Sourcepoint ID for property.
  - `dateCreated` string: Date consent status was created
  - `consentUUID` string: Consent UUID for end-user
  - `messageId` integer: ID of the first layer message shown to end-user
  - `vendorListId` string: ID of the vendor list
  - `vendors` union[]: Vendors consented to
    - union
      - IABAndCustomVendors: Returns IAB and Custom vendor information
        - `id` string: Sourcepoint vendor ID
        - `name` string: Vendor name
        - `vendorType` string: Vendor type
      - GoogleATPVendors: Returns Google ATP vendor information
        - `id` string: Sourcepoint vendor ID
        - `name` string: Vendor name
        - `vendorType` string: Vendor type
        - `googleId` integer: Google vendor ID
  - `legIntVendors` union[]: Vendors consented to who use legitimate interest as a legal basis for at least one purpose.
    - union
      - IABAndCustomVendors: Returns IAB and Custom vendor information
        - `id` string: Sourcepoint vendor ID
        - `name` string: Vendor name
        - `vendorType` string: Vendor type
      - GoogleATPVendors: Returns Google ATP vendor information
        - `id` string: Sourcepoint vendor ID
        - `name` string: Vendor name
        - `vendorType` string: Vendor type
        - `googleId` integer: Google vendor ID
  - `categories` union[]: Purposes consented to
    - union
      - IABPurposes: Returns IAB purpose information
        - `id` string: Sourcepoint purpose ID
        - `name` string: Purpose name
        - `iabPurposeRef` object
          - `name` string: Purpose name
          - `iabId` integer: IAB purpose id
      - CustomPurposes: Returns custom purpose information
        - `id` string: Sourcepoint purpose ID
        - `name` string: Purpose name
  - `legIntCategories` union[]: Purposes consented to who use legitimate interest as a legal basis.
    - union
      - IABPurposes: Returns IAB purpose information
        - `id` string: Sourcepoint purpose ID
        - `name` string: Purpose name
        - `iabPurposeRef` object
          - `name` string: Purpose name
          - `iabId` integer: IAB purpose id
      - CustomPurposes: Returns custom purpose information
        - `id` string: Sourcepoint purpose ID
        - `name` string: Purpose name

---

[API](https://skmtc.dev/privacy-mgmt/apis/sourcepoint-gdpr-tcf-api.md) - [All operations](https://skmtc.dev/privacy-mgmt/apis/sourcepoint-gdpr-tcf-api/llms.txt) - [OpenAPI document](https://skmtc.dev/privacy-mgmt/apis/sourcepoint-gdpr-tcf-api/revisions/4f3d78ea78b5?raw)