---
title: "List client categories"
method: GET
path: "/api/business/{businessId}/category/client"
tags: ["ClientCategory"]
---

# List client categories

`GET /api/business/{businessId}/category/client`

Get a list of client categories for the specified business id. List can be filtered by name and possibility to include archived client categories as well as an option to list only archived client categories

## Path parameters

- `businessId` string, required

## Query parameters

- `name` string
- `archivedOnly` boolean

## Response `200`

Client categories listed

- DataPagedModelClientCategoryResponse
  - `_embedded` object
    - `clientCategories` ClientCategoryResponse[]
      - `categoryId` string
      - `name` string
      - `description` string
      - `archived` boolean
      - `discountOffers` boolean
  - `page` PageMetadata
    - `size` integer
    - `totalElements` integer
    - `totalPages` integer
    - `number` integer

## Other responses

- `400` — Bad Request
- `404` — Business with the specified id doesn't exist
- `429` — Request rate limit exceeded. Current limit set to 100 rps.
- `500` — Internal Server Error

---

[API](https://skmtc.dev/phorest/apis/third-party-api.md) · [All operations](https://skmtc.dev/phorest/apis/third-party-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/phorest/third-party-api/revisions/2218bc90d39c/schema)