Skip to main content
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 — skip this group entirely if you don’t need a catalog.

Endpoints

RouteMethod & pathWhat it does
Create categoryPOST /v1/escrow/category/createCreates a category. multipart/form-data so you can attach a cover imageUrl. Only name is required.
Update categoryPUT /v1/escrow/category/edit/{categoryId}Edit a category’s name, description or image.
List categoriesGET /v1/escrow/category/getPaginated list of your categories (page / limit).
Get category by IDGET /v1/escrow/category/get/{categoryId}Fetch a single category.
Update category positionPUT /v1/escrow/category/position/{categoryId}Re-order a category in your catalog. Body: newPosition.
Delete categoryDELETE /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.