Skip to main content

Categories API

Categories help you organize your products and experiences into logical groups for easier navigation and management.

What is a Category?​

A category is a grouping mechanism that helps:

  • Organize your catalog: Group similar items together
  • Improve navigation: Help customers find what they're looking for
  • Filter listings: Search within specific categories
  • Structure your business: Separate product lines or service types

Two Types of Categories​

EquipDash has separate category systems for products and experiences:

Product Categories​

Organize rental items:

CategoryExample Products
BikesMountain bikes, road bikes, e-bikes
Water SportsKayaks, paddleboards, wetsuits
CampingTents, sleeping bags, backpacks
Winter SportsSkis, snowboards, boots

Experience Categories​

Organize tours and activities:

CategoryExample Experiences
Water ActivitiesKayak tours, snorkeling, diving
AdventureHiking tours, climbing, zip-lining
Classes & LessonsSurf lessons, yoga, cooking classes
CulturalCity tours, museum tours, food tours

Category Structure​

Categories support hierarchical organization with parent-child relationships:

Category
├── id
├── name
├── description (optional)
├── image (optional)
├── parent_id (for subcategories)
├── parent (parent category summary)
├── children (child categories)
└── items_count (products or experiences)

API Endpoints​

Product Categories​

MethodEndpointDescriptionScope Required
GET/v1/product-categoriesList all product categoriesproducts:read
GET/v1/product-categories/{id}Get a single categoryproducts:read
POST/v1/product-categoriesCreate a categoryproducts:write
PATCH/v1/product-categories/{id}Update a categoryproducts:write
DELETE/v1/product-categories/{id}Delete a categoryproducts:write

Experience Categories​

MethodEndpointDescriptionScope Required
GET/v1/experience-categoriesList all experience categoriesexperiences:read
GET/v1/experience-categories/{id}Get a single categoryexperiences:read
POST/v1/experience-categoriesCreate a categoryexperiences:write
PATCH/v1/experience-categories/{id}Update a categoryexperiences:write
DELETE/v1/experience-categories/{id}Delete a categoryexperiences:write

Common Use Cases​

Building a Catalog Navigation​

Fetch categories to build your website navigation:

# Get product categories
curl "https://app.equipdash.com/api/v1/product-categories" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get experience categories
curl "https://app.equipdash.com/api/v1/experience-categories" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filtering Products by Category​

List products in a specific category:

curl "https://app.equipdash.com/api/v1/products?category_id=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Creating a Category Hierarchy​

# 1. Create parent category
curl -X POST "https://app.equipdash.com/api/v1/product-categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Bikes"}'

# 2. Create subcategory
curl -X POST "https://app.equipdash.com/api/v1/product-categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Mountain Bikes", "parent_id": 1}'