---
title: "Retrieve  a vendor"
method: GET
path: "/metadata/vendors/{id}"
tags: ["metadata"]
---

# Retrieve  a vendor

`GET /metadata/vendors/{id}`

Returns  a single vendor with the given ID

## Path parameters

- `id` string, required

## Response `200`

A Vendor object

- MetadataVendors — A vendor is a third-party company that provides services to properties by collecting data, transforming it, ... This object describes a vendor.
  - `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)