metadata

Retrieve a list of vendors

Returns a list of vendors

get/metadata/vendors

Request

  • Base URL
    https://api.didomi.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.didomi.io/metadata/vendors
  • Auth
    HTTP bearer

Query parameters

urlstring

An URL to match to a vendor. This parameter can be repeated multiple times to identify multiple vendors at once.

Response

A list of Vendor objects

idstring required

Vendor ID

namestring required

Name of the vendor

tagsstring[]

Extra classification items for the vendor

websitestring uri

Website URL of the vendor

website_optoutstring uri

URL for consumers to opt-out from data collection and processing from the vendor

hostsstring[]

List of hosts (DNS names) that belong to the vendor

url_patternsstring[]

List of URL patterns (regular expressions) that uniquely identify the vendor

urlsstring[]

If vendors were queried from URLs (with the url query-string parameter), this property contains a list of all URLs that were matched to this vendor

taxonomy_idstring

The ID of the taxonomy item for classifying this vendor

created_atstring date-time

Creation date of the vendor

updated_atstring date-time

Last update date of the vendor

versionnumber

Revision number of the vendor object

Changes

No recorded changes to this operation across all 10 revisions of this API.