---
title: "List categories"
method: GET
path: "/api/v1/categories"
tags: ["General.Category"]
---

# List categories

`GET /api/v1/categories`

<b>The <i>user:read</i> scope is necessary for authenticated requests.</b>

Returns all categories corresponding to a specified locale. The locale is determined based on the authenticated user. If there's no authenticated user, the locale will be based on the query parameter. In the absence of both an authenticated user and a query parameter, a default locale will be used. Please note that the category IDs are returned as UUIDs without any dashes.

## Query parameters

- `locale` string

## Response `200`

The categories were successfully returned.

- unknown[]
  - unknown

## Other responses

- `400` — The payload does not pass validation.
- `401` — If the user is not authorized.

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)