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
/syncpartitionstringThe 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. |
200 (OK)
application/jsonReturns confirmed consent preferences for this user
Response Body
purposesobject(required)Consent purposes 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 |
updatedbooleanHas the consent been updated (including no-change confirmation) since default resolution |
promptedbooleanWhether or not the UI has been shown to the end-user (undefined in older versions of airgap.js) |
uspstringUS Privacy (USP) String |
tcfstringIAB Transparency & Consent Framework (TCF) 2.0 consent metadata |
Response Body Example
Consent for user:
JSON
{
"purposes": {
"TestPurpose": 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/jsonThe token could not be verified or decoded
500 (Internal Server Error)
application/jsonA 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.