netID API
The European netID Foundation established by Mediengruppe RTL Deutschland, ProSiebenSat.1 and United Internet AG pursues the goal of establishing netID as a European alternative to US single sign-on providers. With netID, users can organize their consents for internet services transparently and in compliance with data protection regulations.
Sourcepoint offers API access that allows an end-user's netID consent data to be retrieved.

netID API endpoint

The API endpoint to retrieve an end-user's consent information requires the siteID and consentUUID values.
The API endpoint is the following:
1
https://preprod-cdn.privacy-mgmt.com/consent/tcfv2/consent/v3/{__SITE_ID__}?consentUUID={__CONSENT_UUID__}
Copied!
This API endpoint has two placeholders that need to be replaced with the correct values:
  • A property's site id {__SITE_ID__}
  • The cookie consent UUID {__CONSENT_UUID__}
The site id value can be found by selecting a property from the Dialogue dashboard and navigating to the browser address bar. The site id value will be shown in the browser address bar.
The consentUUID value can be retrieved from the first-party cookie consentUUID.

Retrieve consent status

Your organization can call the API endpoint using a server-side script or a third-party service like Postman.
Server-side script (PHP example
Using Postman
Your organization could use a server side script using code similar to the following PHP example to retrieve an end-user's consent status. You will need to provide the correct values for site id and consentUUID in the script.
1
$site_id = YYYY;
2
$consent_uuid = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX";
3
$api_endpoint = "https://preprod-cdn.privacy-mgmt.com/consent/tcfv2/consent/v3/".$site_id."/tcstring?consentUUID=".$consent_uuid;
4
$handle = curl_init($api_endpoint);
5
$fileHandle = fopen("netID_consent.json", "w");
6
7
/* If you encounter an 'SSL certificate problem: unable to get local issuer certificate' then enable the following two lines */
8
/* This is NOT recommended as a solution and should only be used as a quick and temporary fix */
9
//curl_setopt($handle, CURLOPT_SSL_VERIFYHOST, 0);
10
//curl_setopt($handle, CURLOPT_SSL_VERIFYPEER, 0);
11
12
curl_setopt($handle, CURLOPT_CUSTOMREQUEST, "POST");
13
curl_setopt($handle, CURLOPT_RETURNTRANSFER, true);
14
curl_setopt($handle, CURLOPT_FILE, $fileHandle);
15
16
curl_exec($handle);
17
18
curl_close($handle);
19
fclose($fileHandle);
Copied!
Your organization can use a third party service like Postman to retrieve an end-user's consent status.
Use the POST method and provide the correct API endpoint url and values for site id and consentUUID to retrieve an end-user's consent status.

API JSON response

The API will return the following response if the request to retrieve an end-user's consent status history has been successful.
1
//Example JSON response
2
{
3
"categories": [
4
"5e8b11c3ebdb0627ecca27ab",
5
"5e8b11c3ebdb0627ecca279c",
6
"5e8b11c3ebdb0627ecca279f",
7
"5e8b11c3ebdb0627ecca27a0",
8
"5e8b11c3ebdb0627ecca279d",
9
"5e8b11c3ebdb0627ecca279b",
10
"5e8b11c3ebdb0627ecca279e",
11
"5e8b11c3ebdb0627ecca27a1",
12
"5e8b11c3ebdb0627ecca27a2",
13
"5e8b11c3ebdb0627ecca27a3"
14
],
15
"legIntCategories": [
16
"5e8b11c3ebdb0627ecca279e"
17
],
18
"vendors": [],
19
"legIntVendors": [
20
"5e7792c8d8d48d7950873ff3",
21
"5e7f6927b8e05c48537f6074",
22
"5e7786abf443bb795772efee",
23
"5e77890cd8d48d7950873ef7",
24
"5e7793636fbbc471e4b62573",
25
"5f21834b4e23d23c6c4ce0f3",
26
"5f2a2b392b87b72624a333f2",
27
"5f1b2fbeb8e05c306f2a1ed5"
28
],
29
"_id": "61263285702648036d7d2d8c",
30
"consentUUID": "d0640748-7cae-4d3e-8f72-494a15815923",
31
"siteId": 6804,
32
"vendorListId": "5e7790deb8e05c48537f6052",
33
"rejectedAny": true,
34
"fromNetId": true,
35
"dateCreated": "2021-08-25T12:07:33.691Z",
36
"__v": 0
37
}
Copied!
Parameter
Description
categories, legIntCategories
Purpose ids granted consent by the end-user or which are legitimate interest
vendors, legIntVendors
Vendor ids granted consent by the end-user or which are legitimate interest
_id
The netID request id
consentUUID
The consentUUID value
siteId
The site id value
vendorListId
The active Sourcepoint vendor list id
rejectedAny
Set to true if user has rejected any purpose
dateCreated
The timestamp for the netID request
Last modified 4mo ago