---
title: "List brand requests"
method: GET
path: "/gallery/brand-requests"
tags: ["References"]
---

# List brand requests

`GET /gallery/brand-requests`

## Request

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

Lists your requests to add brands (usually competitors) to the Sequenzy email gallery, newest first, with where each one stands. A request moves from `requested` to `collecting` once the brand is added to the gallery, then to `available` once its emails are in the gallery, when `brand.url` links to them and [List Email References](/api-reference/references/list) can return them. Requests are private to your company. Requires `templates:read`.

## Response `200`

Your brand requests

- object
  - `success` boolean
  - `requests` GalleryBrandRequest[]
    - `id` string
    - `domain` string
    - `note` string, nullable
    - `status` 'requested' | 'collecting' | 'available' | 'declined': `requested`: not in the gallery yet. `collecting`: the brand is added and its emails are being collected. `available`: its emails are in the gallery. `declined`: it will not be added; see `declineReason`.
    - `declineReason` string, nullable
    - `requestedAt` string, date-time
    - `brand` object, nullable: The gallery brand, once its emails are in the gallery.
      - `name` string
      - `slug` string
      - `url` string
  - `limit` integer: How many requests a company can keep, declined ones included.

## 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/brand-requests/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/3d816357b738?raw)