---
title: "GET /categories"
method: GET
path: "/categories"
tags: ["categories"]
---

# GET /categories

`GET /categories`

## Request

- Base URL: `https://api.betteroff.finance`
- URL: `https://api.betteroff.finance/categories`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Response `200`

Success

- object
  - `categories` object[], required: Every category the org has not archived, in one response. Not paginated: the list grows only when a member creates a category.
    - `id` string, uuid, required
    - `userId` string, uuid, nullable, required
    - `key` string, required
    - `identity` string, required
    - `label` string, required
    - `colorVar` string, required
    - `colorHex` string, nullable, required
    - `icon` string, nullable, required
    - `sortOrder` integer, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `default`: Problem details

---

[API](https://skmtc.dev/betteroff/apis/betteroff-api.md) · [All operations](https://skmtc.dev/betteroff/apis/betteroff-api/llms.txt) · [OpenAPI document](https://skmtc.dev/betteroff/apis/betteroff-api/revisions/bc858c8d428d?raw)