emfasemfas

List categories in tree

Returns a paginated list of categories within a category tree.

GET
/category-trees/{treeId}/categories

Authorization

Authorization<token>

API key authentication using Bearer token format. Use: Bearer

In: header

Path Parameters

treeIdstring

Category tree identifier

Query Parameters

search?string

JSON search filters keyed by attribute key

search_mode?string

Filter match mode

Default"\"all\""
Value in"all" | "any"
limit?integer

Results per page

Default100
Range1 <= value <= 200
page?integer

Page number (1-based)

Default1
Range1 <= value

Response Body

curl -X GET "https://api.emfas.ai/v1/category-trees/string/categories?search=string&search_mode=all&limit=100&page=1"
{
  "pagination": {
    "limit": 100,
    "page": 1,
    "totalPages": 3,
    "totalResults": 234
  },
  "result": [
    {
      "displayName": "Smartphones / iPhone",
      "id": "a1b2c3",
      "name": "iPhone",
      "parentId": "b2c3d4"
    }
  ]
}
{
  "error": "Internal server error"
}
{
  "error": "Internal server error"
}
{
  "error": "Internal server error"
}
{
  "error": "Internal server error"
}