List Variations

Get all variations and their properties for a product.

Endpoint

GET /v1/products/{id}/variations

Authentication

Requires an API key with the products:read scope.

Parameters

Parameter	Type	Location	Description
id	integer	path	The product ID

Response

Success (200 OK)

{
  "data": {
    "product_id": 1,
    "has_variations": true,
    "properties": [
      {
        "id": 1,
        "name": "Size"
      },
      {
        "id": 2,
        "name": "Color"
      }
    ],
    "variations": [
      {
        "id": 1,
        "sku": "BIKE-L-RED",
        "display_name": "BIKE-L-RED",
        "description": "Riders 5'9\" and up",
        "image": "https://example.com/images/bike-large-red.jpg",
        "values": [
          {
            "property_id": 1,
            "property_name": "Size",
            "value": "Large"
          },
          {
            "property_id": 2,
            "property_name": "Color",
            "value": "Red"
          }
        ],
        "inventory_count": 5
      },
      {
        "id": 2,
        "sku": "BIKE-M-BLUE",
        "display_name": "BIKE-M-BLUE",
        "description": null,
        "image": null,
        "values": [
          {
            "property_id": 1,
            "property_name": "Size",
            "value": "Medium"
          },
          {
            "property_id": 2,
            "property_name": "Color",
            "value": "Blue"
          }
        ],
        "inventory_count": 3
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-01T10:00:00+00:00"
  }
}

No Variations

If the product doesn't have variations enabled:

{
  "data": {
    "product_id": 1,
    "has_variations": false,
    "properties": [],
    "variations": []
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-01T10:00:00+00:00"
  }
}

Example Request

curl -X GET "https://app.equipdash.com/api/v1/products/1/variations" \
  -H "Authorization: Bearer YOUR_API_KEY"

Errors

Status	Code	Description
401	authentication_required	No API key provided
403	insufficient_scope	API key lacks products:read scope
404	resource_not_found	Product not found