---
title: "Retrieve a list of vendors"
method: GET
path: "/metadata/vendors"
tags: ["metadata"]
---

# Retrieve a list of vendors

`GET /metadata/vendors`

Returns a list of vendors

## Query parameters

- `url` string

## Response `200`

A list of Vendor objects

- MetadataVendors[]
  - `id` string, required — Vendor ID
  - `name` string, required — Name of the vendor
  - `tags` string[] — Extra classification items for the vendor
  - `website` string, uri — Website URL of the vendor
  - `website_optout` string, uri — URL for consumers to opt-out from data collection and processing from the vendor
  - `hosts` string[] — List of hosts (DNS names) that belong to the vendor
  - `url_patterns` string[] — List of URL patterns (regular expressions) that uniquely identify the vendor
  - `urls` string[] — 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_id` string — The ID of the taxonomy item for classifying this vendor
  - `created_at` string, date-time — Creation date of the vendor
  - `updated_at` string, date-time — Last update date of the vendor
  - `version` number — Revision number of the vendor object

---

[API](https://skmtc.net/didomi/apis/didomi-api.md) · [All operations](https://skmtc.net/didomi/apis/didomi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/didomi/didomi-api/versions/da6995016be8/schema)