---
title: "List all owned brands"
method: GET
path: "/brands"
tags: ["Account"]
---

# List all owned brands

`GET /brands`

## Request

- Base URL: `https://www.app.ocoya.com/api/_public/v1`
- URL: `https://www.app.ocoya.com/api/_public/v1/brands`
- Auth: API key in header `X-API-Key`

Returns a short summary of every owned brand: name, website and brand score. Get the full profile with `GET /brands/{brandId}`.

## Response `200`

Success

- object[]
  - `id` string, required: Brand ID. Pass it as `brandId` to brand-scoped endpoints.
  - `name` string, nullable, required: Brand name.
  - `image` string, nullable, required: Brand avatar URL.
  - `timezone` string, nullable, required: Brand timezone.
  - `url` string, required: Brand website, or an empty string.
  - `userCount` integer, required: Number of team members in the brand.
  - `score` integer, required: Brand score out of 100, as the app's sidebar shows it. The full profile and the next step are on `GET /brands/{brandId}`.

## Other responses

- `401`: Missing or invalid API key.
- `429`: Rate limit exceeded: 60 requests per minute per API key.
- `500`: Unknown error

## Changes

- **2026-11-04** `ef9bd3530850`: 4 info
  - added the required property `items/image` to the response with the `200` status
  - added the required property `items/score` to the response with the `200` status
  - added the required property `items/timezone` to the response with the `200` status
  - added the required property `items/url` to the response with the `200` status
- **2026-10-25** `ad0d7f3cdd9b`: 6 info
  - api operation id `listBrands` was added
  - api tag `Account` added
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `500`
  - …2 more
- **2026-09-08** `9b90d34d13fd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ocoya/apis/ocoya-api/changes/brands/get.md)

---

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