# categories.list

List organization categories with parent_id, description, display path ("Events › Hackathons"), taxonomy_key, the caller's last_used_at and rule_count. Contributors see active categories only.

`GET | POST /api/v1/accounting/categories.list`

Permissions: `accounting:read` · Roles: admin, finance, contributor

MCP tool: `accounting_list_categories`

## Fields

This action takes no input fields. Send `{}`.

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/categories.list \
  -H "Authorization: Bearer $OATMILK_API_KEY"
```

Reference page: https://app.getoatmilk.com/docs/api/categories.list