List Business Categories (v1)

Get all business categories with filtering.

Method & Path

GET /v1/admin/business-categories

Description

Retrieves a paginated list of all business categories with optional filtering and search.

Authentication

Required: Admin authentication with businesses.manage permission.

Query Parameters

Parameter	Type	Required	Description
page	number	No	Page number
limit	number	No	Items per page (max: 100)
search	string	No	Search query
status	enum	No	Filter by status: active or inactive

Response 200 OK

{
  "categories": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Beauty Salon",
      "slug": "beauty-salon",
      "status": "active"
    }
  ],
  "meta": {
    "locales": ["en", "ar"],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 50
    }
  }
}

Common Errors

• 401 Unauthorized: Missing or invalid admin authentication token
• 403 Forbidden: Insufficient permissions
• 400 Bad Request: Invalid query parameters
• 500 Internal Server Error: Server error