Skip to main content
GET
/
v3
/
base-products
/
{baseProductId}
/
variants
Get base variants by base product id
curl --request GET \
  --url https://api.snappy.com/public-api/v3/base-products/{baseProductId}/variants \
  --header 'X-Api-Key: <api-key>'
{
  "data": [
    {
      "id": "bv_x9y8z7",
      "title": "<string>",
      "selectedOptions": {},
      "media": [
        {
          "type": "image",
          "src": "https://media.snappy.com/image/asset123?w=1000&h=1000&q=80&f=auto"
        }
      ],
      "baseProductId": "<string>"
    }
  ],
  "links": {
    "first": "/v3/collections/abc/products?page[size]=100",
    "next": "/v3/collections/abc/products?page[cursor]=cursor_abc123&page[size]=100",
    "prev": "<string>"
  }
}

Authorizations

​
X-Api-Key
string
header
required

Partner API key. Finalized per partner integration agreement.

Path Parameters

​
baseProductId
string
required

Base product identifier.

Query Parameters

​
fields
string[]

Optional base-product/base-variant field expansions. Comma-separated.

​
page[number]
integer
default:1

1-indexed page number for page-number paginated endpoints.

Required range: x >= 1
​
page[size]
integer
default:100

Number of base variants per page (max 500, default 100).

Required range: 1 <= x <= 500

Response

Paginated list of base variants.

Paginated base variant list response.

​
data
object[]
required
​
links
object
required

Top-level JSON:API-style pagination links for paginated list responses. first is always present. next is null on the final page. prev is null on the first page (and on cursor-paginated endpoints where backward navigation is not supported).

Last modified on June 17, 2026