---
search:
  tags:
    - Brands
    - GET
seo:
  description: >-
    Lists the Brands of your organization, newest first. Each row gives the
    slug, the name,… Reference for the GET /context/brands endpoint in the
    AdCrunch API.
sidebar:
  label: List the Brands
  badge: GET
title: List the Brands
type: openapi-operation
---
Lists the Brands of your organization, newest first. Each row gives the slug, the name, the description, the logo URL, and whether the body has content. This call does not give the body. To read it, read one Brand. Deleted Brands are not in the list. Each row gives its Assignees.

One page at a time: `limit` rows at most, 100 by default. When the answer holds `nextCursor`, more rows exist: send it back as `cursor` to get the next page.

`GET /context/brands`

**Responses**

- `200` — One page of the Brands of the organization, newest first. \`hasBody\` says whether the body carries prose, so a chooser can rank Brands without the listing becoming the brief. \`logoUrl\` is the public address of the Document the Brand nominates, and it is \`null\` when it nominates none. This page is the last one, so it carries no \`nextCursor\`.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed. Or AdCrunch cannot use the \`cursor\`: it cannot read it, or the cursor belongs to a different query. Then \`error\` is \`invalid\_cursor\`. Send the \`nextCursor\` of the previous page with no change, or omit \`cursor\` to get the first page.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`brand:read\`. \`error\` is \`forbidden\`.

Response example, 200:

```json
{
  "data": [
    {
      "assignees": [
        {
          "id": "usr_4d8b12",
          "name": "Maya Lindqvist"
        }
      ],
      "description": "Running shoes sold direct to the runner, made to last a thousand kilometres.",
      "hasBody": true,
      "id": "brd_6a9c33",
      "logoUrl": "https://documents.adcrunch.dev/org_3a7f10/doc_5e2b41",
      "name": "Acme",
      "slug": "acme"
    },
    {
      "assignees": [],
      "description": "The trail range of Acme, sold to runners who leave the road.",
      "hasBody": false,
      "id": "brd_8f21d0",
      "logoUrl": null,
      "name": "Acme Trail",
      "slug": "acme-trail"
    }
  ]
}
```
