---
title: "/watch-list/{watcher_id}"
method: GET
path: "/v1/watch-list/{watcher_id}"
tags: ["internal"]
---

# /watch-list/{watcher_id}

`GET /v1/watch-list/{watcher_id}`

## Request

- Base URL: `https://api.companydata.dk` (the document declares no server; this is the origin it was published from)
- URL: `https://api.companydata.dk/v1/watch-list/{watcher_id}`
- Auth: HTTP bearer

Read a single Watcher by ID.

## Path parameters

- `watcher_id` string, required

## Response `200`

Successful Response

- WatcherResponse: Response shape for Watcher endpoints.
  - `id` string, required
  - `name` string, required
  - `cvrs` string[], required
  - `rules` WatcherRules: Rule-based discriminator: match any company whose attributes match. Within a field, values are OR'd. Between fields, AND. Example: industry_codes=["561010","561020"] AND municipality_codes=["101"] matches restaurants in Copenhagen.
    - `industry_codes` string[]
    - `municipality_codes` string[]
    - `postal_codes` string[]
    - `company_types` string[]
  - `connection_id` string, nullable
  - `mne_numbers` string[]
  - `unit_numbers` integer[]
  - `event_types` EventType[], required
  - `delivery` WatcherDelivery, required: How matching events should be delivered for this Watcher. At least one channel must be set (webhook_id, email, or both).
    - `webhook_id` string, nullable
    - `email` boolean
    - `email_frequency` 'immediate' | 'daily' | 'weekly': How often to send notification digests.
  - `source` 'user' | 'api' | 'zapier', required: How a Watcher came into existence.
  - `active` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `company_name` string, nullable
  - `person_name` string, nullable
  - `provider_display_name` string, nullable
  - `matched_count` integer, nullable
  - `list_memberships` object[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/companydata/apis/companydata-dk-api.md) · [All operations](https://skmtc.dev/companydata/apis/companydata-dk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/companydata/apis/companydata-dk-api/revisions/1cc6c361ae64?raw)