List categories

Changed on Aug 14, 2026

Fetch all categories (chart of accounts) for the business.

get/categories

Request

Base URL
https://api.boyahq.com/v1
Auth
API key in header X-API-KEY
TypeScript
https://skmtc.dev/boyahq/apis/boya-categories-api/docs/categories/get.ts
A function with typed inputs. Its response is checked against the schema.

Response

Successful response

_idstring

groupidstring

namestring

descriptionstring

statusstring

createdAtstring date-time

updatedAtstring date-time

__vnumber

Example response

[
  {
    "status": "ACTIVE",
    "subcategories": [
      {
        "status": "ACTIVE"
      }
    ]
  }
]

Changes

Aug 14, 2026617707efafe8 Revision changes
- breaking
  the / response's property type changed from integer to number for status
- breaking
  the /// response's property type changed from integer to number for status
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  removed the ACTIVE enum value from the / response property for the response status
- info
  removed the ACTIVE enum value from the /// response property for the response status
- info
  removed the ARCHIVED enum value from the / response property for the response status
- info
  removed the INACTIVE enum value from the /// response property for the response status

Operation history