Get Product Category

Retrieve a single product category by its ID.

Endpoint

GET /v1/product-categories/{id}

Authentication

Requires an API key with the products:read scope.

Parameters

Parameter	Type	Location	Description
id	integer	path	The category ID

Response

Success (200 OK)

{
  "data": {
    "id": 1,
    "name": "Bikes",
    "description": "All types of bikes for rent",
    "image": "https://equipdash.com/storage/categories/bikes.jpg",
    "parent_id": null,
    "parent": null,
    "children": [
      {
        "id": 3,
        "name": "Mountain Bikes",
        "description": "Full suspension and hardtail",
        "image": null,
        "parent_id": 1,
        "product_count": 8,
        "created_at": "2025-01-15T00:00:00+00:00",
        "updated_at": "2025-01-15T00:00:00+00:00"
      },
      {
        "id": 4,
        "name": "Road Bikes",
        "description": "Racing and touring bikes",
        "image": null,
        "parent_id": 1,
        "product_count": 7,
        "created_at": "2025-01-15T00:00:00+00:00",
        "updated_at": "2025-01-15T00:00:00+00:00"
      }
    ],
    "product_count": 15,
    "linked_types": ["experiences", "store"],
    "created_at": "2025-01-01T00:00:00+00:00",
    "updated_at": "2025-01-01T00:00:00+00:00"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-01-15T12:00:00+00:00"
  }
}

Response Fields

Field	Type	Description
id	integer	Unique category identifier
name	string	Category name
description	string|null	Category description
image	string|null	Category image URL
parent_id	integer|null	Parent category ID
parent	object|null	Parent category summary (id, name)
children	array	Child categories
product_count	integer	Number of products in this category, including products for which this is a secondary category.
linked_types	array	Other booking types this category is linked to (experiences, store); 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 products:read scope
404	resource_not_found	Category does not exist

Example Request

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