---
title: "Find an organization's brands"
method: GET
path: "/v1/organizations/{organization_id}/brands"
tags: ["Organization"]
---

# Find an organization's brands

`GET /v1/organizations/{organization_id}/brands`

## Request

- Base URL: `https://api.encircleapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.encircleapp.com/v1/organizations/{organization_id}/brands`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/encircleapp/apis/encircle-public-api/docs/v1/organizations/:organization_id/brands/get.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `X-Encircle-Attribution` string
- `X-Encircle-Request` string

## Response `200`

A list of `OrganizationBrands` under a specific `Organization`.

- object
  - `list` OrganizationBrandResponse[], required
    - `id` integer, required
    - `organization_id` string, uuid, required: A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.
    - `short_name` string, nullable, required: Referred to as the `Brand Name` within the Encircle app.

## Other responses

- `400`: Error processing request.
- `401`: Authentication error.
- `404`: Requested resource does not exist.
- `429`: Rate limit exceeded. See the Rate limiting section for details.

## Changes

- **2026-10-28** `2ed23bd529dc`: 3 warning
  - added the new `outpostsyncerror` enum value to the `code` response property for the response status `400`
  - added the new `outpostsyncerror` enum value to the `code` response property for the response status `401`
  - added the new `outpostsyncerror` enum value to the `code` response property for the response status `404`
- **2026-10-15** `cdc86decd2d7`: 1 info
  - added the non-success response with the status `429`

[Operation history](https://skmtc.dev/encircleapp/apis/encircle-public-api/changes/v1/organizations/:organization_id/brands/get.md)

---

[API](https://skmtc.dev/encircleapp/apis/encircle-public-api.md) - [All operations](https://skmtc.dev/encircleapp/apis/encircle-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/encircleapp/apis/encircle-public-api/revisions/390d8f999da2?raw)