---
title: Categories
description: Chart of accounts for categorization proposals.
canonical: https://bennybooks.com/developers/api/categories
markdown: https://bennybooks.com/developers/api/categories.md
---
# Categories

Chart of accounts for categorization proposals.

> **Documentation index.** Fetch [https://bennybooks.com/developers/llms.txt](https://bennybooks.com/developers/llms.txt) before browsing further. Prefer markdown (this file or `Accept: text/markdown`). Site-wide map: [https://bennybooks.com/llms.txt](https://bennybooks.com/llms.txt).

Always call list_categories before proposing categorizations. Prefer the code field (e.g. 5100). Synonyms help match informal bank memos to the canonical name.

### `GET https://bennybooks.com/api/v1/categories`

Chart of accounts with stable codes, synonyms, and parent links. Call before proposing categorizations. Prefer categoryCode over display names.

- operationId: `list_categories`
- scope: `read`

**Response**

```json
{
  "data": [
    {
      "code": "5100",
      "name": "Software & tools",
      "type": "expense",
      "parentCode": "5000",
      "synonyms": ["Software", "SaaS", "Subscriptions"],
      "inUse": true
    }
  ]
}
```

> Semantic model and counterparties: Reference → Ontology. Full write-up: docs/ONTOLOGY.md

---

## Machine-readable

- HTML: https://bennybooks.com/developers/api/categories
- Markdown: https://bennybooks.com/developers/api/categories.md
- Docs index: https://bennybooks.com/developers/llms.txt
- OpenAPI: https://bennybooks.com/openapi.json
- Skill: https://bennybooks.com/skill.md
- Auth: https://bennybooks.com/auth.md

```json
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "Categories",
  "description": "Chart of accounts for categorization proposals.",
  "url": "https://bennybooks.com/developers/api/categories",
  "inLanguage": "en",
  "encodingFormat": [
    "text/html",
    "text/markdown"
  ],
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "BennyBooks",
    "url": "https://bennybooks.com"
  },
  "mainEntityOfPage": "https://bennybooks.com/developers/api/categories",
  "workExample": {
    "@type": "CreativeWork",
    "url": "https://bennybooks.com/developers/api/categories.md",
    "encodingFormat": "text/markdown",
    "name": "Categories (Markdown)"
  },
  "about": {
    "@type": "WebAPI",
    "name": "BennyBooks Agent API",
    "url": "https://bennybooks.com/api/v1",
    "documentation": "https://bennybooks.com/developers"
  }
}
```