---
title: "List categories"
method: GET
path: "/categories"
---

# List categories

`GET /categories`

Fetch all categories (chart of accounts) for the business.

## Response `200`

Successful response

- Category[]
  - `_id` string
  - `groupid` string
  - `name` string
  - `description` string
  - `status` string
  - `subcategories` Subcategory[]
    - `_id` string
    - `group_id` string
    - `category` string
    - `code` string
    - `name` string
    - `description` string
    - `status` string
    - `teams` string[]
    - `mapping_id` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `__v` number
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `__v` number

## Changes

- **2026-08-14** `617707efafe8` — 2 breaking, 6 info
  - the `items/__v` response's property type changed from `integer` to `number` for status `200`
  - the `items/subcategories/items/__v` response's property type changed from `integer` to `number` for status `200`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - …4 more

[Change history](https://skmtc.dev/boyahq/apis/boya-categories-api/changes/categories/get.md)

---

[API](https://skmtc.dev/boyahq/apis/boya-categories-api.md) · [All operations](https://skmtc.dev/boyahq/apis/boya-categories-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/boyahq/boya-categories-api/revisions/617707efafe8/schema)