v1

latestOpenAPI 3.0.22026-07-146916.1 KB

GDPR TCF end-user consent status

Merge end-user consent status with identity provider

Merge an end-user's custom vendor consent profile with the information Sourcepoint has for IAB vendors taken from a TCString that is provided. Though originally planned for the German consortium NetId, it is available for any identity provider to confirm or revoke vendor consent in one place<br><br>Your organization will require their own CMP ID to use this API. Please contact your Sourcepoint Client Support team if you require more information.

post/consent/v3/{siteId}/tcstring

Path parameters

siteIdinteger required

The property ID for the property in the Sourcepoint portal.

Query parameters

consentUUIDstring

Retrieved from the first-party cookie consentUUID

Request body

euconsentstring required

tcString for end-user

Example request

{
  "euconsent": "CPOA6HgPOA6HgFZABCDEBwCgAP_AAEwAAAYgIDpb_T7VbWFCWf59fvsgOYxXVMCeA"
}

Response

Success

appendedConsentUUIDstring

consentUUID for end-user after request

Example response

{
  "userConsentRecord": {
    "categories": [
      "5f9aa28f7ab71b20a1b12345"
    ],
    "legIntCategories": [
      "5f9aa28fabcd1b20a1babcde"
    ],
    "vendors": [
      "12343c6c091a5047885cf964"
    ],
    "legIntVendors": [
      "abcd3c6c12345047885cf964"
    ],
    "id": "645b8e5f19a120048b8d24f8",
    "consentUUID": "ab126231-e899-4fbb-b7e2-e8f762f080e6_14",
    "siteId": 1234,
    "euconsent": "12344IAPrf4IAAjABCENDDCgAP_AAAAAACiQI5hV5DrMTWFAUXxZQNsgOYgU1sATIGQCCBCAAyABAAGA8AQA0WESEASAAAACAAAAowIBAAAEGAFEAAAAAAAEABEAAAQAgAAIIABAAAEQAAIAAAgIAAAAAAAAAAABAAAAmAAQIcKAREAAAIAQIgAAAAABAAAAAgIABAAAAAAAAAAAAgAAAAAAAAAAAAACARAAgAAAPCQKQAEAALAAqABkADkAHwAgABkADQAHkARABFACYAE8AN4AcwA_ACEAENAIgAiQBLACaAFKALcAYcA-wD9AIoARoAjgBJgCUgFzAMUAbQA3ACRAFDgLzAYMAw0AAMgAaAA8gCIAIoATAAngBSADEAHMAPwAhoBEAESAKUAWIAtwBowD7AP0Ai0BHAEdAJSAXMAvIBigDaAG4APsAi8BIgChwF5gMNAZIAywBrIDgigAUAC4AJAA2gEiALqAAA.YAAAAAAAAAAA",
    "vendorListId": "5f9aa290a228638af82db511",
    "fromNetId": true,
    "dateCreated": "2023-05-10T12:30:23.918Z"
  },
  "appendedConsentUUID": "ab126231-e899-4fbb-b7e2-e8f762f080e6_14_19"
}