Get product with variants

Retrieve a product and its variants with pagination support.

GET /api/v1/products/{productId}

Headers:
  Authorization: Bearer <api-key>
  Content-Type: application/json

Path parameters

Parameter	Type	Description
`productId`	string	Required - The Shopify product REST ID

Query parameters

Parameter	Type	Description
`limit`	integer	Optional - Number of variants per page. Must be between 1 and 100. Default: 50
`cursor`	string	Optional - Pagination cursor from a previous response to fetch the next or previous page

Response example (200 success)

{
  "success": true,
  "data": {
    "product": {
      "id": "123",
      "measurementType": "weight",
      "variants": [
        {
          "id": "456",
          "unitMeasurement": {
            "unit": "kg",
            "value": 1
          },
          "settings": {
            "onlineStore": {
              "displayStyle": "number",
              "rules": {
                "min": 0.5,
                "increment": 0.5,
                "defaultValue": 1,
                "max": null
              }
            }
          }
        }
      ]
    }
  },
  "meta": {
    "nextCursor": "eyJ...",
    "prevCursor": null,
    "hasMore": true
  }
}

Response fields

Field	Type	Description
`success`	boolean	Indicates whether the request was successful
`data`	object	Response data object
`data.product`	Product	The product object with nested variants
`meta`	PaginationMeta	Pagination metadata for cursor-based navigation

Error responses

Status code	Description
400	Bad Request - Invalid product ID or invalid limit parameter
401	Unauthorized - Missing or invalid API key
404	Not Found - Product not found
500	Internal Server Error - Server error while processing the request

Note

Responses are cached for 5 minutes server-side
Products with zero variants will return an empty array with proper pagination metadata
Use meta.nextCursor to fetch the next page, or meta.prevCursor for the previous page
The limit parameter controls how many variants are returned per page (1-100)

See the Variant object and PaginationMeta documentation for response structure details.