List Store Categories

Retrieve a paginated list of store categories.

Endpoint

GET /v1/store-categories

Authentication

Requires an API key with the store:read scope.

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number
per_page	integer	15	Items per page (max 100)
parent_id	integer	-	Filter by parent category ID
root_only	boolean	-	Set to true to return only top-level categories (no parent)

Response

Success (200 OK)

{
  "data": [
    {
      "id": 1,
      "name": "Accessories",
      "description": "Skiing and snowboarding accessories",
      "image_url": "https://example.com/storage/categories/accessories.jpg",
      "parent_id": null,
      "products_count": 8,
      "children": [
        {
          "id": 4,
          "name": "Wax & Tuning",
          "description": "Ski and snowboard maintenance products",
          "image_url": null,
          "parent_id": 1,
          "products_count": 3,
          "children": [],
          "created_at": "2026-01-10T00:00:00+00:00",
          "updated_at": "2026-01-10T00:00:00+00:00"
        }
      ],
      "linked_types": ["rentals"],
      "created_at": "2026-01-10T00:00:00+00:00",
      "updated_at": "2026-01-10T00:00:00+00:00"
    },
    {
      "id": 2,
      "name": "Apparel",
      "description": "Branded clothing and merchandise",
      "image_url": "https://example.com/storage/categories/apparel.jpg",
      "parent_id": null,
      "products_count": 15,
      "children": [],
      "linked_types": [],
      "created_at": "2026-01-12T00:00:00+00:00",
      "updated_at": "2026-01-12T00:00:00+00:00"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 2,
    "total_pages": 1,
    "request_id": "req_abc123",
    "timestamp": "2026-02-13T12:00:00+00:00"
  }
}

Response Fields

Store Category

Field	Type	Description
id	integer	Unique category identifier
name	string	Category name
description	string|null	Category description
image_url	string|null	Full URL to the category image
parent_id	integer|null	Parent category ID (null for top-level)
products_count	integer	Number of products in this category, including products for which this is a secondary category.
children	array	Child categories (recursive)
linked_types	array	Other booking types this category is linked to (rentals, experiences); empty when not linked
created_at	string	ISO 8601 datetime
updated_at	string	ISO 8601 datetime

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks store:read scope

Example Request

curl -X GET "https://app.equipdash.com/api/v1/store-categories?root_only=true" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..."