---
title: "Get categories for account"
method: GET
path: "/rest/accounts/{account-id}/categories"
tags: ["Aggregations"]
---

# Get categories for account

`GET /rest/accounts/{account-id}/categories`

## Request

- Base URL: `https://api.nrich.qwist.cloud`
- URL: `https://api.nrich.qwist.cloud/rest/accounts/{account-id}/categories`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/qwist/apis/finx-api/docs/rest/accounts/:account-id/categories/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of categories associated to the transactions of this account. Each category entry also includes aggregated statistics of the referenced transactions like total amount, number of transactions, high and low values.

## Parameters

- `#/paths/~1catalog/get/parameters/0` (unresolved $ref)
- `#/paths/~1rest~1accounts~1{account-id}/get/parameters/0` (unresolved $ref)
- `#/paths/~1rest~1timeline/get/parameters/3` (unresolved $ref)
- `#/paths/~1rest~1categories/get/parameters/4` (unresolved $ref)
- `#/paths/~1rest~1timeline/get/parameters/0` (unresolved $ref)
- `#/paths/~1rest~1timeline/get/parameters/1` (unresolved $ref)
- `#/paths/~1rest~1categories/get/parameters/7` (unresolved $ref)
- `#/paths/~1rest~1categories/get/parameters/8` (unresolved $ref)
- `#/paths/~1rest~1categories/get/parameters/9` (unresolved $ref)

## Other responses

- `200` (unresolved $ref)
- `400` (unresolved $ref)
- `401` (unresolved $ref)

## Changes

- **2026-11-03** `398592d93b1f`: 1 breaking
  - added the new path request parameter `account-id`

[Operation history](https://skmtc.dev/qwist/apis/finx-api/changes/rest/accounts/:account-id/categories/get.md)

---

[API](https://skmtc.dev/qwist/apis/finx-api.md) - [All operations](https://skmtc.dev/qwist/apis/finx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qwist/apis/finx-api/revisions/398592d93b1f?raw)