---
title: "Get categories list"
method: GET
path: "/accounting-api/categories"
tags: ["Accounting (only available for accounting add-on users)"]
---

# Get categories list

`GET /accounting-api/categories`

Retrieve a paginated list of categories with optional filtering.
        Supports filtering by name.

## Query parameters

- `q` string
- `skip` number
- `limit` number

## Response `200`

List of categories with pagination information

- object
  - `skip` number, required
  - `limit` number, required
  - `current` number, required
  - `total` number, required
  - `data` object[], required — List of categories
    - `id` string, required — Category UUID
    - `name` string, required — Category name
    - `createdByUser` object, required — User who created the category. For regular users: { id: "5d6e7a7ebf8e3800207735ae", name: "John Doe" }. For system: { id: "guesty", name: "Guesty" }
      - `id` string, required — Creator user ID
      - `name` string — Creator user name

## Other responses

- `400` — Invalid query parameters provided
- `403` — You do not have sufficient permissions to access this resource
- `500` — Unhandled exception. Something went wrong on server

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)