Catalog (categories) overview - Payluk API

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 and 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	`POST /v1/escrow/category/create`	Creates a category. `multipart/form-data` so you can attach a cover `imageUrl`. Only `name` is required.
Update category	`PUT /v1/escrow/category/edit/{categoryId}`	Edit a category’s `name`, `description` or image.
List categories	`GET /v1/escrow/category/get`	Paginated list of your categories (`page` / `limit`).
Get category by ID	`GET /v1/escrow/category/get/{categoryId}`	Fetch a single category.
Update category position	`PUT /v1/escrow/category/position/{categoryId}`	Re-order a category in your catalog. Body: `newPosition`.
Delete category	`DELETE /v1/escrow/category/delete/{categoryId}`	Removes a category.

Grab a categoryId from List categories and pass it as categoryId on Create escrow or Create milestone escrow.