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

# List brands for a project

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

The endpoint receives as path param project id. If the project exists, the list of brands for the project is returned. Additional filters can be applied as query params. By default, ARCHIVED brands are not returned. To include them, the status filter must be used.

## Path parameters

- `projectId` string, required

## Query parameters

- `status` BrandStatus[]
- `brandType` 'US_SHORT_CODE_REGISTRY', enum
- `orderBy` string
- `pageSize` integer
- `pageToken` string
- `brandName` string

## Response `200`

OK

- ListBrandResponse[]
  - `brands` BasicBrand[] — List of brands
    - `brandId` string — The unique identifier for the brand.
    - `brandName` string — The name of the brand.
    - `brandMetadataId` string — The unique identifier for the brand metadata.
    - `status` 'DRAFT' | 'NEW' | 'PENDING' | 'PENDING_REVIEW' | 'REJECTED' | 'INCOMPLETE' | 'COMPLETED' | 'ARCHIVED', enum
    - `callbackUrl` string — The URL to receive the brand status update callback. The URL must be a valid URL and must be reachable from Sinch.
    - `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.
  - `nextPageToken` string — Token to request the next page of results.
  - `totalSize` integer — Total count of brands matching provided search criteria

## Other responses

- `404` — NOT_FOUND: The project id introduced does not exist.
- `500` — INTERNAL: Internal server error. Typically, a server bug.

---

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