Get consent preferences for a user at https://consent.transcend.io or https://consent.us.transcend.io. N.B. This is not a Sombra route. This API requires a signed token including an encrypted identifier. See reference for details.

GET

/sync

Header Parameters

Authorizationstring
A JWT including an encrypted identifier

Query Parameters

partitionstring
The consent partition or bundle ID. You can find the partition value under Consent Management > Developer Settings. If this value is not set, please use your bundle ID.

Response

200 (OK)

application/json

Returns confirmed consent preferences for this user

Response Body

purposesobject(required)
Consent purposes to update
communicationPreferencesobject
Communication Preferences to update
confirmedboolean(required)
Was tracking consent confirmed by the user? If this is false, the consent was resolved from defaults & is not yet confirmed
timestampstring(required)
Timestamp of when consent was collected
updatedboolean
Has the consent been updated (including no-change confirmation) since default resolution
promptedboolean
Whether or not the UI has been shown to the end-user (undefined in older versions of airgap.js)
uspstring
US Privacy (USP) String
tcfstring
IAB Transparency & Consent Framework (TCF) 2.0 consent metadata

Response Body Example

Consent for user:

{
  "purposes": {
    "TestPurpose": false
  },
  "communicationPreferences": {
    "Email": true,
    "Sms": false
  },
  "confirmed": true,
  "timestamp": "2023-05-11T19:32:31.707Z"
}

204 (No Content)

No consent preferences have been confirmed for this user

400 (Bad Request)

application/json

The token could not be verified or decoded

500 (Internal Server Error)

application/json

A 500 error means the backend is having issues. You check our system status at status.transcend.io. Please reach out to Transcend support if you're experiencing this error.