Get Store Category

Retrieve a single store category by its ID, including child categories and product count.

Endpoint

GET /v1/store-categories/{id}

Authentication

Requires an API key with the store:read scope.

Parameters

Parameter	Type	Location	Description
id	integer	path	The store category ID

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"
      },
      {
        "id": 5,
        "name": "Locks & Storage",
        "description": null,
        "image_url": null,
        "parent_id": 1,
        "products_count": 5,
        "children": [],
        "created_at": "2026-01-11T00:00:00+00:00",
        "updated_at": "2026-01-11T00: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"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-13T12:00:00+00:00"
  }
}

Response Fields

See List Store Categories for complete field descriptions.

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
404	resource_not_found	Store category does not exist

Example Request

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