Skip to content
BolderBolder API
Esc
navigateopen⌘Jpreview

List variants

Returns variants for a product.

GET/products/{product_id}/variants
Authorization
AuthorizationBearer token (JWT) · headerrequired
Path parameters
product_idstringrequired
Product ID or slug
Query parameters
pageinteger
default: 1
per_pageinteger
default: 20
Responses
200Paginated variants list
_embeddedobject
Show properties
itemsVariant[]
Show properties
Array of Variant
_linksHalLinks
idinteger
product_idinteger
namestring
Display name, computed from option1/option2/option3.
statusstring
Allowed:visiblehidden
skustring
barcode_numberstring
option1string
option2string
option3string
currency_codestring
regular_priceinteger
Regular price in cents
sale_priceinteger | null
Sale price in cents
priceinteger
Effective price in cents (sale_price if set, else regular_price)
online_stockinteger
all_stockinteger
available_if_no_stockboolean
weight_in_gramsinteger
unit_quantitynumber
colorstring
costinteger
profitinteger
stocksobject[]
Per-location stock breakdown
Show properties
Array of object
location_idinteger
available_unitsinteger
total_unitsinteger
Request
curl -X GET "https://api.onbolder.com/v2/products/101/variants" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "_class": [
    "results",
    "variants"
  ],
  "total_items": 3,
  "per_page": 20,
  "page": 1,
  "_embedded": {
    "items": [
      {
        "id": 201,
        "product_id": 101,
        "name": "Small",
        "sku": "WH-001-S",
        "option1": "Small",
        "currency_code": "USD",
        "regular_price": 8999,
        "price": 8999,
        "online_stock": 10
      }
    ]
  }
}