emfasemfas
Category Trees{treeId}Categories

List Categories in Tree

Retrieves a paginated list of categories within a specific category tree. Each category includes its ID, name, display name (hierarchical path), and parent ID if applicable. Supports filtering via the search parameter.

GET
/category-trees/{treeId}/categories
Authorization<token>

API key authentication using Bearer token format. Use: Bearer

In: header

Path Parameters

treeIdstring

Category tree external ID

Query Parameters

search?string

JSON search filters keyed by attribute key

search_mode?string

Filter match mode: 'all' (AND) or 'any' (OR)

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

Number of results to return 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=%22all%22&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"
}