> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brand-wallet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a category

> Retrieve a single BrandWallet product category by id.

```http theme={null}
GET $BASE_URL/v1/categories/{id}
```

**Returns the details of a single category.**

> **Auth:** `Authorization: Bearer <accessToken>` — an organization-scoped token from [Authentication](/api/authentication). Requesting a category that belongs to another organization returns `auth_error` (400).

### Path parameters

| Parameter | Type | Description |
| - | - | - |
| `id` | string | Category id (UUID). |

### Example

```bash theme={null}
curl --request GET \
  --url "$BASE_URL/v1/categories/79a83256-2925-44b4-9bdc-a401caccf969" \
  --header 'Authorization: Bearer <accessToken>'
```

### Response

```json theme={null}
{
  "id": "79a83256-2925-44b4-9bdc-a401caccf969",
  "name": { "TR": "Espresso Bazlı", "EN": "Espresso Based" },
  "description": "Espresso based drinks",
  "organization": "07f84834-1184-4eb6-82f5-7eda13231fc3",
  "status": 1,
  "opaqueId": "espresso-based",
  "parent": "1e1cc0fb-55a1-4679-80df-6dccb936273f",
  "createdAt": "2026-09-18T09:23:28.303Z",
  "updatedAt": "2026-09-18T09:23:28.303Z"
}
```

Notes:

* An unknown or deleted (`status: -99`) id returns `entity_not_found` (400) — deleted categories cannot be read.
* `name` may be a plain string or a language object; optional fields that have no value (`parent`, `description`, …) are omitted from the response — do not expect `null`.