---
title: "List brands for a project"
method: GET
path: "/v1/projects/{projectId}/us/brands"
tags: ["brands"]
---

# List brands for a project

`GET /v1/projects/{projectId}/us/brands`

List existing brands according to the specified filters.

## Path parameters

- `projectId` string, required

## Query parameters

- `status` BrandStatus[]
- `displayName` string
- `channelName` 'RCS' | 'SHORT_CODE' | 'TENDLC' — Channel represents the different channels that can be assigned to a brand after completing a brand order. Each channel has different requirements and it is assigned after completing a specific brand order process.
- `contentProvider` boolean
- `sort` string
- `pageSize` integer
- `pageToken` string

## Response `200`

OK

- ListBrandResponse — List of Brands response
  - `brands` BasicBrand[] — List of brands
    - `brandId` string — The unique identifier for the brand.
    - `displayName` string — The name of the brand. DisplayName must be unique per projectId and marketCode (US)
    - `status` 'DRAFT' | 'ACTIVE' | 'ARCHIVED' — Brand status represents the current state of the brand in the system. It is determined by the status of the brand orders and the channels assigned to the brand. The status can be DRAFT when the brand is being created or updated, ACTIVE when the brand has at least one channel assigned and it is ready to be used, or ARCHIVED when the brand has been cancelled and it can not be used anymore.
    - `channels` Channel[] — Channels available for this Brand
    - `createTime` string, date-time — The date and time when the brand was created.
    - `updateTime` string, date-time — The date and time when the brand was updated.
  - `links` Links — Pagination links.
    - `next` string — Link to the next page of results, following RFC 8288. Absence of this link indicates the last page.
  - `meta` PaginationMeta — Pagination metadata for list responses.
    - `totalCount` integer — Total count of resources matching the provided search criteria. This field cannot be null; an empty result will return 0.

## Other responses

- `401` — UNAUTHENTICATED: Missing or invalid authentication credentials.
- `403` — PERMISSION_DENIED: The authenticated user does not have permission to perform this operation.
- `404` — NOT_FOUND: The project id introduced does not exist.
- `429` — RESOURCE_EXHAUSTED: Too many requests. The client has exceeded the rate limit.
- `500` — INTERNAL: Internal server error. Typically, a server bug.

---

[API](https://skmtc.net/sinch/apis/sinch-compliance-api-brands.md) · [All operations](https://skmtc.net/sinch/apis/sinch-compliance-api-brands/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/sinch-compliance-api-brands/revisions/fcc788f31a0a/schema)