Get Vendor List UI

📘

Note

If vendor lists are not in scope for your implementation, disregard this page.

API

(GET) https://mobile-data.onetrust.io/cfw/cmp/v1/vendors

API Reference: https://developer.onetrust.com/onetrust/reference/get_vendors

Request header

Sample response (success)

{
   "errors": [],
    "appConfig": {
        "showBanner": true,
        "bannerReason": "Geo rule Banner is enabled and is first launch.",
        "bannerReasonCode": 101,
        "templateType": "IAB2V2"
    },
    "iab2V2Vendors": {
        "purposes": {
            "1": {
                "id": 1,
                "name": "Store and/or access information on a device",
                "description": "Cookies, device or similar online identifiers (e.g. login-based identifiers, randomly assigned identifiers, network based identifiers) together with other information (e.g. browser type and information, language, screen size, supported technologies etc.) can be stored or read on your device to recognise it each time it connects to an app or to a website, for one or several of the purposes presented here.",
                "iabIllustrations": [
                    "Most purposes explained in this notice rely on the storage or accessing of information from your device when you use an app or visit a website. For example, a vendor or publisher might need to store a cookie on your device during your first visit on a website, to be able to recognise your device during your next visits (by accessing this cookie each time)."
                ]
            },
            "2": {
                "id": 2,
                "name": "Use limited data to select advertising",
                "description": "Advertising presented to you on this service can be based on limited data, such as the website or app you are using, your non-precise location, your device type or which content you are (or have been) interacting with (for example, to limit the number of times an ad is presented to you).",
                "iabIllustrations": [
                    "A car manufacturer wants to promote its electric vehicles to environmentally conscious users living in the city after office hours. The advertising is presented on a page with related content (such as an article on climate change actions) after 6:30 p.m. to users whose non-precise location suggests that they are in an urban zone.",
                    "A large producer of watercolour paints wants to carry out an online advertising campaign for its latest watercolour range, diversifying its audience to reach as many amateur and professional artists as possible and avoiding showing the ad next to mismatched content (for instance, articles about how to paint your house). The number of times that the ad has been presented to you is detected and limited, to avoid presenting it too often."
                ]
            },
            "3": {
                "id": 3,
                "name": "Create profiles for personalised advertising",
                "description": "Information about your activity on this service (such as forms you submit, content you look at) can be stored and combined with other information about you (for example, information from your previous activity on this service and other websites or apps) or similar users. This is then used to build or improve a profile about you (that might include possible interests and personal aspects). Your profile can be used (also later) to present advertising that appears more relevant based on your possible interests by this and other entities.",
                "iabIllustrations": [
                    "If you read several articles about the best bike accessories to buy, this information could be used to create a profile about your interest in bike accessories. Such a profile may be used or improved later on, on the same or a different website or app to present you with advertising for a particular bike accessory brand. If you also look at a configurator for a vehicle on a luxury car manufacturer website, this information could be combined with your interest in bikes to refine your profile and make an assumption that you are interested in luxury cycling gear.",
                    "An apparel company wishes to promote its new line of high-end baby clothes. It gets in touch with an agency that has a network of clients with high income customers (such as high-end supermarkets) and asks the agency to create profiles of young parents or couples who can be assumed to be wealthy and to have a new child, so that these can later be used to present advertising within partner apps based on those profiles."
                ]
            },
            "4": {
                "id": 4,
                "name": "Use profiles to select personalised advertising",
                "description": "Advertising presented to you on this service can be based on your advertising profiles, which can reflect your activity on this service or other websites or apps (like the forms you submit, content you look at), possible interests and personal aspects.",
                "iabIllustrations": [
                    "An online retailer wants to advertise a limited sale on running shoes. It wants to target advertising to users who previously looked at running shoes on its mobile app. Tracking technologies might be used to recognise that you have previously used the mobile app to consult running shoes, in order to present you with the corresponding advertisement on the app.",
                    "A profile created for personalised advertising in relation to a person having searched for bike accessories on a website can be used to present the relevant advertisement for bike accessories on a mobile app of another organisation."
                ]
            },
            "5": {
                "id": 5,
                "name": "Create profiles to personalise content",
                "description": "Information about your activity on this service (for instance, forms you submit, non-advertising content you look at) can be stored and combined with other information about you (such as your previous activity on this service or other websites or apps) or similar users. This is then used to build or improve a profile about you (which might for example include possible interests and personal aspects). Your profile can be used (also later) to present content that appears more relevant based on your possible interests, such as by adapting the order in which content is shown to you, so that it is even easier for you to find content that matches your interests.",
                "iabIllustrations": [
                    "You read several articles on how to build a treehouse on a social media platform. This information might be added to a profile to mark your interest in content related to outdoors as well as do-it-yourself guides (with the objective of allowing the personalisation of content, so that for example you are presented with more blog posts and articles on treehouses and wood cabins in the future).",
                    "You have viewed three videos on space exploration across different TV apps. An unrelated news platform with which you have had no contact builds a profile based on that viewing behaviour, marking space exploration as a topic of possible interest for other videos."
                ]
            },
            "6": {
                "id": 6,
                "name": "Use profiles to select personalised content",
                "description": "Content presented to you on this service can be based on your content personalisation profiles, which can reflect your activity on this or other services (for instance, the forms you submit, content you look at), possible interests and personal aspects, such as by adapting the order in which content is shown to you, so that it is even easier for you to find (non-advertising) content that matches your interests.",
                "iabIllustrations": [
                    "You read articles on vegetarian food on a social media platform and then use the cooking app of an unrelated company. The profile built about you on the social media platform will be used to present you vegetarian recipes on the welcome screen of the cooking app.",
                    "You have viewed three videos about rowing across different websites. An unrelated video sharing platform will recommend five other videos on rowing that may be of interest to you when you use your TV app, based on a profile built about you when you visited those different websites to watch online videos."
                ]
            },
            "7": {
                "id": 7,
                "name": "Measure advertising performance",
                "description": "Information regarding which advertising is presented to you and how you interact with it can be used to determine how well an advert has worked for you or other users and whether the goals of the advertising were reached. For instance, whether you saw an ad, whether you clicked on it, whether it led you to buy a product or visit a website, etc. This is very helpful to understand the relevance of advertising campaigns.",
                "iabIllustrations": [
                    "You have clicked on an advertisement about a “black Friday” discount by an online shop on the website of a publisher and purchased a product. Your click will be linked to this purchase. Your interaction and that of other users will be measured to know how many clicks on the ad led to a purchase.",
                    "You are one of very few to have clicked on an advertisement about an “international appreciation day” discount by an online gift shop within the app of a publisher. The publisher wants to have reports to understand how often a specific ad placement within the app, and notably the “international appreciation day” ad, has been viewed or clicked by you and other users, in order to help the publisher and its partners (such as agencies) optimise ad placements."
                ]
            },
            "8": {
                "id": 8,
                "name": "Measure content performance",
                "description": "Information regarding which content is presented to you and how you interact with it can be used to determine whether the (non-advertising) content e.g. reached its intended audience and matched your interests. For instance, whether you read an article, watch a video, listen to a podcast or look at a product description, how long you spent on this service and the web pages you visit etc. This is very helpful to understand the relevance of (non-advertising) content that is shown to you.",
                "iabIllustrations": [
                    "You have read a blog post about hiking on a mobile app of a publisher and followed a link to a recommended and related post. Your interactions will be recorded as showing that the initial hiking post was useful to you and that it was successful in interesting you in the related post. This will be measured to know whether to produce more posts on hiking in the future and where to place them on the home screen of the mobile app.",
                    "You were presented a video on fashion trends, but you and several other users stopped watching after 30 seconds. This information is then used to evaluate the right length of future videos on fashion trends."
                ]
            },
            "9": {
                "id": 9,
                "name": "Understand audiences through statistics or combinations of data from different sources",
                "description": "Reports can be generated based on the combination of data sets (like user profiles, statistics, market research, analytics data) regarding your interactions and those of other users with advertising or (non-advertising) content to identify common characteristics (for instance, to determine which target audiences are more receptive to an ad campaign or to certain contents).",
                "iabIllustrations": [
                    "The owner of an online bookstore wants commercial reporting showing the proportion of visitors who consulted and left its site without buying, or consulted and bought the last celebrity autobiography of the month, as well as the average age and the male/female distribution of each category. Data relating to your navigation on its site and to your personal characteristics is then used and combined with other such data to produce these statistics.",
                    "An advertiser wants to better understand the type of audience interacting with its adverts. It calls upon a research institute to compare the characteristics of users who interacted with the ad with typical attributes of users of similar platforms, across different devices. This comparison reveals to the advertiser that its ad audience is mainly accessing the adverts through mobile devices and is likely in the 45-60 age range."
                ]
            },
            "10": {
                "id": 10,
                "name": "Develop and improve services",
                "description": "Information about your activity on this service, such as your interaction with ads or content, can be very helpful to improve products and services and to build new products and services based on user interactions, the type of audience, etc. This specific purpose does not include the development or improvement of user profiles and identifiers.",
                "iabIllustrations": [
                    "A technology platform working with a social media provider notices a growth in mobile app users, and sees based on their profiles that many of them are connecting through mobile connections. It uses a new technology to deliver ads that are formatted for mobile devices and that are low-bandwidth, to improve their performance.",
                    "An advertiser is looking for a way to display ads on a new type of consumer device. It collects information regarding the way users interact with this new kind of device to determine whether it can build a new mechanism for displaying advertising on this type of device."
                ]
            },
            "11": {
                "id": 11,
                "name": "Use limited data to select content",
                "description": "Content presented to you on this service can be based on limited data, such as the website or app you are using, your non-precise location, your device type, or which content you are (or have been) interacting with (for example, to limit the number of times a video or an article is presented to you).",
                "iabIllustrations": [
                    "A travel magazine has published an article on its website about the new online courses proposed by a language school, to improve travelling experiences abroad. The school’s blog posts are inserted directly at the bottom of the page, and selected on the basis of your non-precise location (for instance, blog posts explaining the course curriculum for different languages than the language of the country you are situated in).",
                    "A sports news mobile app has started a new section of articles covering the most recent football games. Each article includes videos hosted by a separate streaming platform showcasing the highlights of each match. If you fast-forward a video, this information may be used to select a shorter video to play next."
                ]
            }
        },"specialPurposes": {
            "1": {
                "id": 1,
                "name": "Ensure security, prevent and detect fraud, and fix errors",
                "description": "Your data can be used to monitor for and prevent unusual and possibly fraudulent activity (for example, regarding advertising, ad clicks by bots), and ensure systems and processes work properly and securely. It can also be used to correct any problems you, the publisher or the advertiser may encounter in the delivery of content and ads and in your interaction with them.",
                "iabIllustrations": [
                    "An advertising intermediary delivers ads from various advertisers to its network of partnering websites. It notices a large increase in clicks on ads relating to one advertiser, and uses data regarding the source of the clicks to determine that 80% of the clicks come from bots rather than humans."
                ]
            },
            "2": {
                "id": 2,
                "name": "Deliver and present advertising and content",
                "description": "Certain information (like an IP address or device capabilities) is used to ensure the technical compatibility of the content or advertising, and to facilitate the transmission of the content or ad to your device.",
                "iabIllustrations": [
                    "Clicking on a link in an article might normally send you to another page or part of the article. To achieve this, 1°) your browser sends a request to a server linked to the website, 2°) the server answers back (“here is the article you asked for”), using technical information automatically included in the request sent by your device, to properly display the information / images that are part of the article you asked for. Technically, such exchange of information is necessary to deliver the content that appears on your screen."
                ]
            }
        },
        "features": {
            "1": {
                "id": 1,
                "name": "Match and combine data from other data sources",
                "description": "Information about your activity on this service may be matched and combined with other information relating to you and originating from various sources (for instance your activity on a separate online service, your use of a loyalty card in-store, or your answers to a survey), in support of the purposes explained in this notice.",
                "iabIllustrations": []
            },
            "2": {
                "id": 2,
                "name": "Link different devices",
                "description": "In support of the purposes explained in this notice, your device might be considered as likely linked to other devices that belong to you or your household (for instance because you are logged in to the same service on both your phone and your computer, or because you may use the same Internet connection on both devices).",
                "iabIllustrations": []
            },
            "3": {
                "id": 3,
                "name": "Identify devices based on information transmitted automatically",
                "description": "Your device might be distinguished from other devices based on information it automatically sends when accessing the Internet (for instance, the IP address of your Internet connection or the type of browser you are using) in support of the purposes exposed in this notice.",
                "iabIllustrations": []
            }
        },
        "specialFeatures": {
            "1": {
                "id": 1,
                "name": "Use precise geolocation data",
                "description": "With your acceptance, your precise location (within a radius of less than 500 metres) may be used in support of the purposes explained in this notice.",
                "iabIllustrations": []
            },
            "2": {
                "id": 2,
                "name": "Actively scan device characteristics for identification",
                "description": "With your acceptance, certain characteristics specific to your device might be requested and used to distinguish it from other devices (such as the installed fonts or plugins, the resolution of your screen) in support of the purposes explained in this notice.",
                "iabIllustrations": []
            }
        }, "vendors": {
            "1": {
                "purposes": [
                    1,
                    2,
                    3,
                    4,
                    7,
                    8,
                    9,
                    10
                ],
                "legIntPurposes": [],
                "flexiblePurposes": [
                    2,
                    7,
                    8,
                    9,
                    10
                ],
                "specialPurposes": [
                    1,
                    2
                ],
                "features": [
                    1,
                    2,
                    3
                ],
                "specialFeatures": [],
                "id": 1,
                "name": "Exponential Interactive, Inc d/b/a VDX.tv",
                "iab2V2GVLVersion": 7,
                "dataDeclaration": [
                    1,
                    3,
                    4,
                    6,
                    8,
                    10,
                    11
                ],
                "urls": {
                    "langId": "en",
                    "privacy": "https://vdx.tv/privacy/",
                    "legIntClaim": "https://cdnx.exponential.com/wp-content/uploads/2018/04/Balancing-Assessment-for-Legitimate-Interest-Publishers-v2.pdf"
                },
                "dataRetention": {
                    "stdRetention": 397,
                    "purposes": {},
                    "specialPurposes": {}
                },
                "cookieMaxAgeSeconds": 7776000,
                "usesNonCookieAccess": false,
                "deviceStorageDisclosureUrl": "https://vdxtv.expo.workers.dev",
                "legIntStatus": "-1",
                "consentStatus": "1"
            },
            "2": {
                "purposes": [
                    1,
                    2,
                    3,
                    4,
                    7,
                    9,
                    10
                ],
                "legIntPurposes": [],
                "flexiblePurposes": [],
                "specialPurposes": [
                    1,
                    2
                ],
                "features": [
                    2
                ],
                "specialFeatures": [
                    2
                ],
                "id": 2,
                "name": "Captify Technologies Limited",
                "iab2V2GVLVersion": 7,
                "dataDeclaration": [
                    1,
                    2,
                    4,
                    6,
                    11
                ],
                "urls": {
                    "langId": "en",
                    "privacy": "https://www.captifytechnologies.com/privacy-notice/",
                    "legIntClaim": "https://www.captifytechnologies.com/privacy-notice/"
                },
                "dataRetention": {
                    "stdRetention": 365,
                    "purposes": {},
                    "specialPurposes": {}
                },
                "cookieMaxAgeSeconds": 31536000,
                "usesNonCookieAccess": true,
                "deviceStorageDisclosureUrl": "https://static.cpx.to/gvl/deviceStorageDisclosure.json",
                "legIntStatus": "-1",
                "consentStatus": "1"
            },
            "4": {
                "purposes": [
                    1,
                    2,
                    3,
                    4,
                    7,
                    9,
                    10
                ],
                "legIntPurposes": [],
                "flexiblePurposes": [],
                "specialPurposes": [],
                "features": [
                    1,
                    2,
                    3
                ],
                "specialFeatures": [
                    1
                ],
                "id": 4,
                "name": "Roq.ad GmbH",
                "iab2V2GVLVersion": 21,
                "dataDeclaration": [
                    1,
                    2,
                    3,
                    4,
                    5,
                    6,
                    8,
                    9,
                    11
                ],
                "urls": {
                    "langId": "en",
                    "privacy": "https://www.roq.ad/privacy-policy-roqad/"
                },
                "dataRetention": {
                    "stdRetention": 365,
                    "purposes": {},
                    "specialPurposes": {}
                },
                "cookieMaxAgeSeconds": 31536000,
                "usesNonCookieAccess": false,
                "deviceStorageDisclosureUrl": "https://roqad-public.s3.eu-central-1.amazonaws.com/tcf-disclosure.json",
                "legIntStatus": "-1",
                "consentStatus": "1"
            },
            "6": {
                "purposes": [
                    1,
                    2,
                    3,
                    4,
                    7,
                    9
                ],
                "legIntPurposes": [],
                "flexiblePurposes": [],
                "specialPurposes": [
                    1,
                    2
                ],
                "features": [
                    3
                ],
                "specialFeatures": [],
                "id": 6,
                "name": "AdSpirit GmbH",
                "iab2V2GVLVersion": 7,
                "dataDeclaration": [
                    1,
                    2,
                    3,
                    4,
                    6,
                    8,
                    10,
                    11
                ],
                "urls": {
                    "langId": "en",
                    "privacy": "https://help.adspirit.de/privacy.php",
                    "legIntClaim": "https://help.adspirit.de/privacy.php"
                },
                "dataRetention": {
                    "stdRetention": 60,
                    "purposes": {
                        "2": 14,
                        "7": 14
                    },
                    "specialPurposes": {}
                },
                "cookieMaxAgeSeconds": 2592000,
                "usesNonCookieAccess": false,
                "deviceStorageDisclosureUrl": "https://help.adspirit.de/deviceStorage.json",
                "legIntStatus": "-1",
                "consentStatus": "1"
            }},
             "IABDataCategories": {
            "1": {
                "id": 1,
                "name": "IP addresses"
            },
            "2": {
                "id": 2,
                "name": "Device characteristics"
            },
            "3": {
                "id": 3,
                "name": "Device identifiers"
            },
            "4": {
                "id": 4,
                "name": "Probabilistic identifiers"
            },
            "5": {
                "id": 5,
                "name": "Authentication-derived identifiers"
            },
            "6": {
                "id": 6,
                "name": "Browsing and interaction data"
            },
            "7": {
                "id": 7,
                "name": "User-provided data"
            },
            "8": {
                "id": 8,
                "name": "Non-precise location data"
            },
            "9": {
                "id": 9,
                "name": "Precise location data"
            },
            "10": {
                "id": 10,
                "name": "Users’ profiles"
            },
            "11": {
                "id": 11,
                "name": "Privacy choices"
            }
        },
        "vendorListVersion": 35,
        "lastUpdated": "2024-01-11T16:07:36Z"
        },
        "googleVendors": {
          "vendors":{
           "43": {
                "id": 43,
                "name": "AdPredictive",
                "policyUrl": "https://adpredictive.com/privacy",
                "consentStatus": "1"
            },
            "46": {
                "id": 46,
                "name": "Adriver",
                "policyUrl": "https://www.adriver.ru/about/privacy-en/",
                "consentStatus": "1"
            },
            "55": {
                "id": 55,
                "name": "Adtelligence",
                "policyUrl": "https://adtelligence.com/en/data-privacy/",
                "consentStatus": "1"
            },
            "61": {
                "id": 61,
                "name": "Artsai",
                "policyUrl": "https://artsai.com/privacy/",
                "consentStatus": "1"
            }
          },
           "vendorListVersion": 1
        },
        "vendorListUIData": {
        "general": {
            "backgroundColor": "#FFFFFF",
            "backgroundColorDark": "#FFFFFF",
            "toggleActiveColor": "#6CC04A",
            "toggleActiveColorDark": "#6CC04A",
            "toggleInactiveColor": "#FFFFFF",
            "lineBreakColor": "#dedede",
            "lineBreakColorDark": "#dedede",
            "titleTextColor": "#696969",
            "titleTextColorDark": "#696969",
            "disclosureTintColor": "#696969",
            "disclosureTintColorDark": "#696969",
            "pageHeaderTitle": "IAB Vendors",
            "iabVendorsTitle": "IAB Vendors",
            "googleVendorsTitle": "Google Vendors",
            "allowAllConsentText": "Allow All Consent",
            "showFilterIcon": true,
            "buttonFocusColor": "#696969",
            "buttonFocusTextColor": "#FFFFFF",
            "buttonActiveColor": "#DEDEDE",
            "buttonActiveTextColor": "#696969",
            "menu": {
                "color": "#F4F4F4",
                "textColor": "#696969",
                "focusColor": "#696969",
                "focusTextColor": "#FFFFFF",
                "activeColor": "#DEDEDE",
                "activeTextColor": "#696969"
            },
            "filter": {
                "onColor": "#346E4A",
                "onColorDark": "#346E4A",
                "color": "#696969",
                "colorDark": "#696969"
            },
            "searchBar": {
                "backgroundColorDark": "#FFFFFF",
                "searchNoResultsFoundText": "No Results Found",
                "searchPlaceholderText": "Search Vendors",
                "searchResultsTotalText": "Total",
                "textColor": "#696969",
                "textColorDark": "#696969"
            },
            "buttons": {
                "backButton": {
                    "color": "#696969",
                    "colorDark": "#696969",
                    "backBtnVoiceOverText": "Back"
                },
                "filterCloseButton": {
                    "text": "Cancel",
                    "titleFontSize": "17",
                    "titleTextColor": "#FFFFFF",
                    "titleTextColorDark": "#FFFFFF"
                },
                "filterApplyButton": {
                    "borderRadius": "",
                    "color": "#346E4A",
                    "colorDark": "#346E4A",
                    "fontSize": "17",
                    "text": "Apply",
                    "textColor": "#FFFFFF",
                    "textColorDark": "#FFFFFF"
                },
                "savePreferencesButton": {
                    "borderRadius": "",
                    "color": "#346E4A",
                    "colorDark": "#346E4A",
                    "fontSize": "17",
                    "text": "Confirm My Choices",
                    "textColor": "#FFFFFF",
                    "textColorDark": "#FFFFFF",
                    "interactionType": "VENDOR_LIST_CONFIRM"
                }
            }
        },
        "vendorDetailsUIData": {
            "backButtonColor": "#696969",
            "backButtonColorDark": "#696969",
            "vendorsPolicyText": "View Privacy Policy",
            "legIntClaimPolicyText": "View Legitimate Interest Claim",
            "consentToggleText": "Consent",
            "legitInterestToggleText": "Legitimate Interest",
            "consentPurposes": "Consent Purposes",
            "features": "Features",
            "specialFeatures": "Special Features",
            "specialPurposes": "Special Purposes",
            "legitimateInterestPurposesText": "Legitimate Interest Purposes",
            "lifespan": "Lifespan",
            "lifespanDay": "Day",
            "lifespanDays": "Days",
            "lifespanMonth": "Month",
            "lifespanMonths": "Months",
            "disclosureTitle": "Device Storage Disclosure",
            "nonCookieUsageText": "This vendor utilizes other methods of storage or accessing information in addition to cookies.",
            "storageIdentifierText": "Identifier",
            "storageIdentifierType": "Type",
            "storagePurposes": "Purposes",
            "storageDomain": "Domain",
            "dataDeclarationText": "Data Declaration",
            "dataRetentionText": "Data Retention",
            "dataStdRetentionText": "Standard Retention",
            "title": {
                "fontSize": "22",
                "show": true,
                "textAlign": "left",
                "textColor": "#696969",
                "textColorDark": "#696969"
            },
            "description": {
                "show": true,
                "fontSize": "16",
                "textAlign": "left",
                "textColor": "#696969",
                "textColorDark": "#696969"
            },
            "link": {
                "fontSize": "17",
                "textAlign": "left",
                "textColor": "#3860BE",
                "textColorDark": "#3860BE"
            }
        }
    },
    "otConsentString": "eyJMYXN0TGF1bmNoRGF0ZSI6MTcwNTM1NTczNDk2NiwiU2hvdWxkU2hvd0Jhbm5lciI6MSwiRFNJRCI6ImU1NTI3NzYyLTA0N2EtNDBmZi05MmUwLTI0ODM4ZDYyNjFlZiJ9"
}

Sample response (Error)

{
    "errors": [
        {
            "code": "ERROR_CODE_MISSING_REQUIRED_HEADER",
            "message": "Request header OT-Device-Type should not be null"
        }
    ]
}

Consent value dictionary - legIntStatus and consentStatus

Banner reason code

Response errors