List categories

GET 
/categories

Returns a cursor-paginated page of categories for the workspace tied to the token's sub claim. Company-scoped within the workspace; categories form a tree via parent_id but are returned flat — build the tree client-side using parent_id and level. Requires scope finance.categories.

Request

Responses

200

Page of categories plus pagination metadata.

400

Malformed query (unknown filter / operator, invalid limit, bad cursor).

401

Missing / invalid / expired / revoked token.

403

Token authenticated but lacks the finance.categories scope, or sub does not match any workspace.

500

Unhandled server error.