Get a category - BrandWallet

GET $BASE_URL/v1/categories/{id}

Returns the details of a single category.

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

Path parameters

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

Example

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

Response

{
  "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.

Last modified on September 29, 2026