---
search:
  tags:
    - Brands
    - GET
seo:
  description: >-
    Reads one Brand by its slug. The answer has its body and the current
    revision.… Reference for the GET /context/brands/{slug} endpoint in the
    AdCrunch API.
sidebar:
  label: Get a Brand by slug
  badge: GET
title: Get a Brand by slug
type: openapi-operation
---
Reads one Brand by its slug. The answer has its body and the current revision. Send that revision back as `base_revision` when you update the Brand. A body that nobody wrote is `null`.

`GET /context/brands/{slug}`

**Responses**

- `200` — The Brand with its body. It does \*\*not\*\* carry its Personas — ask \`GET /context/brands/{slug}/personas\` for those.
- `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.
- `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\`.
- `404` — No Brand with that slug in this organization. \`error\` is \`not\_found\`.

Response example, 200:

```json
{
  "assignees": [
    {
      "id": "usr_4d8b12",
      "name": "Maya Lindqvist"
    }
  ],
  "body": "## Identity\n\nAcme makes one running shoe and sells it direct. The promise is a thousand kilometres on the same pair, and a resole rather than a replacement.\n\n## Voice\n\nPlain and measured. Short sentences. No superlative the shoe cannot earn.\n\n## Guidelines\n\n- Name the distance, never the \"journey\".\n- Claim the kilometres the shoe is tested to, and no more.\n- Do not compare the shoe to a named competitor.\n\n## Messaging\n\n- One shoe, a thousand kilometres.\n- Resole it twice, and keep running on it.\n- Sold direct, so the price is the cost of the shoe.",
  "createdAt": 1790000000000,
  "createdBy": "usr_4d8b12",
  "description": "Running shoes sold direct to the runner, made to last a thousand kilometres.",
  "id": "brd_6a9c33",
  "logoDocumentId": "doc_5e2b41",
  "name": "Acme",
  "revision": 4,
  "slug": "acme",
  "updatedAt": 1790086400000,
  "websiteUrl": "https://acme.example"
}
```
