---
title: "Retrieve a paginated list of Categories by query parameter(s)"
method: GET
path: "/categories"
tags: ["Categories"]
---

# Retrieve a paginated list of Categories by query parameter(s)

`GET /categories`

## Headers

- `Trace-Id` string
- `End-User-Agent` string
- `End-User-Ip` string
- `End-User-OS` string
- `End-User-Device-Id` string
- `End-User-Device-Manufacturer` string
- `End-User-Device-Model` string

## Response `200`

A list of Categories

- object
  - `data` Category[]
    - `id` string, uuid
    - `displayName` string
  - `pagination` PaginationObject
    - `offset` integer
    - `limit` integer
    - `total` integer
    - `hasNextPage` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/plastiq/apis/plastiq-public-api.md) · [All operations](https://skmtc.dev/plastiq/apis/plastiq-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plastiq/plastiq-public-api/revisions/cfd776dd9ac5/schema)