---
title: "List watched brands"
method: GET
path: "/gallery/watchlist"
tags: ["References"]
---

# List watched brands

`GET /gallery/watchlist`

## Request

- Base URL: `https://api.sequenzy.com/api/v1`
- URL: `https://api.sequenzy.com/api/v1/gallery/watchlist`
- Auth: HTTP bearer

Lists the brands your company watches, usually competitors, newest watch first. This is the dashboard's **Competitors** page. A brand already in the Sequenzy email gallery is `available`, with how many of its emails are in the gallery and when the newest was sent. Read the emails with [List Watched Brand Emails](/api-reference/references/watchlist-emails). A watch is a brand request, so [List Brand Requests](/api-reference/references/brand-requests-list) returns the same rows. Requires `templates:read`.

## Response `200`

Your watched brands

- object
  - `success` boolean
  - `watchlist` GalleryWatchedBrand[]
    - `id` string: Watch ID. The same row is a brand request, so this is also its request ID.
    - `domain` string
    - `note` string, nullable
    - `status` 'requested' | 'collecting' | 'available' | 'declined': `available`: its emails are in the gallery. `requested`: not in the gallery yet. `collecting`: the brand is added and its emails are being collected. `declined`: it will not be added; see `declineReason`.
    - `declineReason` string, nullable
    - `watchedAt` string, date-time
    - `emailCount` integer: The brand's emails in the gallery. 0 unless `available`.
    - `latestEmailAt` string, date-time, nullable: When its newest email in the gallery was sent. `null` unless `available`.
    - `brand` object, nullable: The gallery brand, once its emails are in the gallery.
      - `name` string
      - `slug` string
      - `url` string
  - `limit` integer: How many watches and brand requests a company can keep together.

## Other responses

- `401`: Unauthorized
- `403`: API key lacks `templates:read`

## Changes

- **2026-10-16** `db3873ca3d4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/gallery/watchlist/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) - [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sequenzy/apis/sequenzy-api/revisions/8156dc12d8b4?raw)