---
title: "List brands"
method: GET
path: "/api/relay/rest/registry/beta/brands"
tags: ["Campaign Registry: Brands"]
---

# List brands

`GET /api/relay/rest/registry/beta/brands`

Lists the project's US 10-digit long code (10DLC) brand registrations. Each brand represents the business identity that must be registered before its messaging use cases can become campaigns. Use [Get brand](/docs/apis/rest/campaign-registry/brands/retrieve-brand) when you already have the brand ID.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_ and _Numbers_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Query parameters

- `filter_name` string
- `filter_state` string

## Response `200`

The request has succeeded.

- BrandListResponse — Response containing a list of brands.
  - `links` PaginationLinks — Pagination links for list responses.
    - `self` string, required — Link to the current page.
    - `first` string, required — Link to the first page.
    - `next` string — Link to the next page. Only present when there are more results.
    - `prev` string — Link to the previous page. Only present when not on the first page.
  - `data` Brand[] — List of brands.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `state` string — The current state of the brand.
    - `name` string — Brand/Marketing/DBA name of the business if applicable.
    - `company_name` string — The legal name of the business.
    - `contact_email` string — A company contact email for this brand.
    - `contact_phone` string — A contact phone number for this brand.
    - `signalwire_contact_emails` string[] — Email addresses SignalWire uses for registration correspondence about this brand and its campaigns. Defaults to the first administrator on the account.
    - `ein_issuing_country` string — Country of registration.
    - `legal_entity_type` string — What type of legal entity is the organization? (PRIVATE_PROFIT, PUBLIC_PROFIT, NON_PROFIT)
    - `ein` string — Company EIN Number/Tax ID.
    - `company_address` string — Full company address.
    - `company_vertical` string — An optional Vertical for the brand (REAL_ESTATE, HEALTHCARE, ENERGY, ENTERTAINMENT, RETAIL, AGRICULTURE, INSURANCE, EDUCATION, HOSPITALITY, FINANCIAL, GAMBLING, CONSTRUCTION, NGO, MANUFACTURING, GOVERNMENT, TECHNOLOGY, COMMUNICATION).
    - `company_website` string — Link to the company website.
    - `csp_brand_reference` string — If you are your own Campaign Service Provider, this is the approved Brand ID (Mandatory for CSPs, otherwise please omit).
    - `csp_self_registered` boolean — This value must be true for all self-registered brands.
    - `status_callback_url` string — Optional: Specify a URL to receive webhook notifications when your brand's state changes. See the [10DLC status callback](/docs/apis/rest/webhooks/ten-dlc-status-callback) docs for the webhook payload.
    - `created_at` string, date-time — Timestamp when the brand was created.
    - `updated_at` string, date-time — Timestamp when the brand was last updated.

## Other responses

- `401` — Access is unauthorized.
- `500` — An internal server error occurred.

## Changes

> 161 revisions in range; 3 could not be searched.

- **2026-09-18** `c4ac621ccf3c` — 1 info
  - added the optional property `data/items/signalwire_contact_emails` to the response with the `200` status

[Change history](https://skmtc.dev/signalwire/apis/signalwire-rest-api/changes/api/relay/rest/registry/beta/brands/get.md)

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/20ee0f568ece?raw)