> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payluk.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Catalog (categories) overview

> Optional product categories you can attach to escrows to organise your catalog.

Categories are an **optional** organisational layer. Create them once, then pass a
`categoryId` when creating an escrow to group your listings (and to filter them
later in [escrow feeds](/api-reference/disputes/get-escrow-feeds) and
[transactions](/api-reference/escrow/list-escrow-transactions)). They never move
money, so skip this group entirely if you don't need a catalog.

## Endpoints

| Route                                                                          | Method & path                                    | What it does                                                                                                 |
| ------------------------------------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| [Create category](/api-reference/categories/create-category)                   | `POST /v1/escrow/category/create`                | Creates a category. **`multipart/form-data`** so you can attach a cover `imageUrl`. Only `name` is required. |
| [Update category](/api-reference/categories/update-category)                   | `PUT /v1/escrow/category/edit/{categoryId}`      | Edit a category's `name`, `description` or image.                                                            |
| [List categories](/api-reference/categories/list-categories)                   | `GET /v1/escrow/category/get`                    | Paginated list of your categories (`page` / `limit`).                                                        |
| [Get category by ID](/api-reference/categories/get-category-by-id)             | `GET /v1/escrow/category/get/{categoryId}`       | Fetch a single category.                                                                                     |
| [Update category position](/api-reference/categories/update-category-position) | `PUT /v1/escrow/category/position/{categoryId}`  | Re-order a category in your catalog. Body: `newPosition`.                                                    |
| [Delete category](/api-reference/categories/delete-category)                   | `DELETE /v1/escrow/category/delete/{categoryId}` | Removes a category.                                                                                          |

<Tip>
  Grab a `categoryId` from [List categories](/api-reference/categories/list-categories)
  and pass it as `categoryId` on
  [Create escrow](/api-reference/escrow/create-escrow) or
  [Create milestone escrow](/api-reference/milestone-escrow/create-milestone-escrow).
</Tip>