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

# Get categories

`GET /v6/categories`

Get all categories for the authenticated user, grouped by type

## Response `200`

Success

- SuccessResponseCategoriesGetResponse
  - `result` 'SUCCESS' | 'FAILURE' — The result of the action performed.
  - `data` CategoriesGetResponse — The data generated by the action performed.
    - `expense` CategoryGetDto[], required — Expense categories
      - `id` string, required — Id of the category
      - `name` string, required — Name of the category
      - `status` 'ACTIVE' | 'INACTIVE' | 'REMOVED', required — Status of the category
      - `iconUrl` string, nullable, required — Icon URL of the category
      - `children` CategoryChildGetDto[], required — Child categories (one level of nesting only)
        - `id` string, required — Id of the category
        - `name` string, required — Name of the category
        - `status` 'ACTIVE' | 'INACTIVE' | 'REMOVED', required — Status of the category
        - `iconUrl` string, nullable, required — Icon URL of the category
        - `customData` JsonNode, nullable — Custom JSON in which you can store any data with max length of 2000 characters
          - `empty` boolean
          - `array` boolean
          - `null` boolean
          - `object` boolean
          - `float` boolean
          - `string` boolean
          - `number` boolean
          - `missingNode` boolean
          - `valueNode` boolean
          - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
          - `pojo` boolean
          - `integralNumber` boolean
          - `floatingPointNumber` boolean
          - `short` boolean
          - `int` boolean
          - `long` boolean
          - `double` boolean
          - `bigDecimal` boolean
          - `bigInteger` boolean
          - `textual` boolean
          - `boolean` boolean
          - `binary` boolean
          - `container` boolean
          - `embeddedValue` boolean
      - `customData` JsonNode, nullable — Custom JSON in which you can store any data with max length of 2000 characters
        - `empty` boolean
        - `array` boolean
        - `null` boolean
        - `object` boolean
        - `float` boolean
        - `string` boolean
        - `number` boolean
        - `missingNode` boolean
        - `valueNode` boolean
        - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
        - `pojo` boolean
        - `integralNumber` boolean
        - `floatingPointNumber` boolean
        - `short` boolean
        - `int` boolean
        - `long` boolean
        - `double` boolean
        - `bigDecimal` boolean
        - `bigInteger` boolean
        - `textual` boolean
        - `boolean` boolean
        - `binary` boolean
        - `container` boolean
        - `embeddedValue` boolean
    - `revenue` CategoryGetDto[], required — Revenue categories
      - `id` string, required — Id of the category
      - `name` string, required — Name of the category
      - `status` 'ACTIVE' | 'INACTIVE' | 'REMOVED', required — Status of the category
      - `iconUrl` string, nullable, required — Icon URL of the category
      - `children` CategoryChildGetDto[], required — Child categories (one level of nesting only)
        - `id` string, required — Id of the category
        - `name` string, required — Name of the category
        - `status` 'ACTIVE' | 'INACTIVE' | 'REMOVED', required — Status of the category
        - `iconUrl` string, nullable, required — Icon URL of the category
        - `customData` JsonNode, nullable — Custom JSON in which you can store any data with max length of 2000 characters
          - `empty` boolean
          - `array` boolean
          - `null` boolean
          - `object` boolean
          - `float` boolean
          - `string` boolean
          - `number` boolean
          - `missingNode` boolean
          - `valueNode` boolean
          - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
          - `pojo` boolean
          - `integralNumber` boolean
          - `floatingPointNumber` boolean
          - `short` boolean
          - `int` boolean
          - `long` boolean
          - `double` boolean
          - `bigDecimal` boolean
          - `bigInteger` boolean
          - `textual` boolean
          - `boolean` boolean
          - `binary` boolean
          - `container` boolean
          - `embeddedValue` boolean
      - `customData` JsonNode, nullable — Custom JSON in which you can store any data with max length of 2000 characters
        - `empty` boolean
        - `array` boolean
        - `null` boolean
        - `object` boolean
        - `float` boolean
        - `string` boolean
        - `number` boolean
        - `missingNode` boolean
        - `valueNode` boolean
        - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
        - `pojo` boolean
        - `integralNumber` boolean
        - `floatingPointNumber` boolean
        - `short` boolean
        - `int` boolean
        - `long` boolean
        - `double` boolean
        - `bigDecimal` boolean
        - `bigInteger` boolean
        - `textual` boolean
        - `boolean` boolean
        - `binary` boolean
        - `container` boolean
        - `embeddedValue` boolean
    - `transfer` CategoryChildGetDto[], required — Transfer categories
      - `id` string, required — Id of the category
      - `name` string, required — Name of the category
      - `status` 'ACTIVE' | 'INACTIVE' | 'REMOVED', required — Status of the category
      - `iconUrl` string, nullable, required — Icon URL of the category
      - `customData` JsonNode, nullable — Custom JSON in which you can store any data with max length of 2000 characters
        - `empty` boolean
        - `array` boolean
        - `null` boolean
        - `object` boolean
        - `float` boolean
        - `string` boolean
        - `number` boolean
        - `missingNode` boolean
        - `valueNode` boolean
        - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
        - `pojo` boolean
        - `integralNumber` boolean
        - `floatingPointNumber` boolean
        - `short` boolean
        - `int` boolean
        - `long` boolean
        - `double` boolean
        - `bigDecimal` boolean
        - `bigInteger` boolean
        - `textual` boolean
        - `boolean` boolean
        - `binary` boolean
        - `container` boolean
        - `embeddedValue` boolean

## Other responses

- `400` — Bad request
- `401` — Not authenticated
- `403` — Not authorized
- `404` — Endpoint not found
- `500` — Internal server error

---

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