Printago API
GET /v1/sku-variants

Get all SKU variants for a store

List your store's variant options (such as Color or Size). See POST /v1/sku-variants for how options, values, bindings and properties fit together. Variant endpoints require a commercial account.

Supports the same query parameters as other list endpoints: exact-match filters such as name=Color or isPersonalization=true, field.operator=value filters, sort, limit (up to 1000), offset and meta=true. Add include=values, include=properties or include=bindings (comma-separate to combine) to embed each option's values, properties or SKU bindings.

Requires: sku.view

Query Parameters

name optional
string
Filter on name. A bare value is an exact match (name=value); use name.<operator>=value for the other operators (ne, gt, gte, lt, lte, contains, startsWith, endsWith, in, notIn, isNull; which ones a field accepts depends on its type). See Querying Data.
isPersonalization optional
string
Filter on isPersonalization. A bare value is an exact match (isPersonalization=value); use isPersonalization.<operator>=value for the other operators (ne, gt, gte, lt, lte, contains, startsWith, endsWith, in, notIn, isNull; which ones a field accepts depends on its type). See Querying Data.
aliases optional
string
Alternate names (as the merchant typed them) that resolve to this option.
id optional
string
Filter by record ID. A bare value is an exact match; use id.in=a,b,c for several (up to 100). See Querying Data.
storeId optional
string
Filter by store ID. Results are always limited to the store your API key belongs to, so this is rarely useful. See Querying Data.
createdAt optional
string
Filter by creation time. Pass an ISO 8601 timestamp with a comparison operator, e.g. createdAt.gte=2025-01-01T00:00:00Z. See Querying Data.
updatedAt optional
string
Filter by last-modified time. Pass an ISO 8601 timestamp with a comparison operator, e.g. updatedAt.gt=2025-01-01T00:00:00Z to fetch what changed since a checkpoint. See Querying Data.
sort optional
string
Comma-separated field:direction pairs, applied in order, e.g. createdAt:desc,name:asc. Direction is asc (the default) or desc. At most 5 clauses; JSON and array fields cannot be sorted on. See Querying Data.
limit optional
number
Maximum number of records to return, 1–1000. Defaults to 1000; larger values are capped at 1000. See Querying Data.
offset optional
number
Number of matching records to skip before returning results. Combine with limit to page through a list, and with meta=true to learn the total. See Querying Data.
fields optional
string
Comma-separated list of fields to return, e.g. id,name,updatedAt. Other fields are left out of each record. At most 50 fields. See Querying Data.
include optional
string
Comma-separated related records to embed in each result, e.g. linkedParts,linkedParts.part. At most 4 includes, each at most 2 levels deep; only the relations this endpoint supports are accepted, anything else is a 400. See Querying Data.
meta optional
boolean
Set to true to wrap the response as { data, meta }, where meta carries total, count, offset, limit, hasMore and executionTime. Without it the response is a bare array. See Querying Data.
hints optional
boolean
Set to true to add a hints array of suggested follow-up API calls to the response (aimed at AI agents). A list response is wrapped as { data, meta, hints }. See Querying Data.

Examples

Options with their values

Request 
GET /v1/sku-variants?include=values&sort=name:asc
Response 
[
  {
    "id": "v2a6r0i4a8n1t5c9o3l7o2r6",
    "storeId": "k3m9x2p7q8r4t6v1w5y0z3a2",
    "name": "Color",
    "isPersonalization": false,
    "aliases": [],
    "createdAt": "2026-09-23T16:20:01.114Z",
    "updatedAt": "2026-09-23T16:20:01.114Z",
    "values": [
      {
        "id": "r3e7d1v5a9l2u6e0q4w8e3r7",
        "optionId": "v2a6r0i4a8n1t5c9o3l7o2r6",
        "name": "Red",
        "skuSuffixes": [
          "-RED"
        ],
        "order": 0
      },
      {
        "id": "b4l8u2e6v0a3l7u1e5q9w3e8",
        "optionId": "v2a6r0i4a8n1t5c9o3l7o2r6",
        "name": "Blue",
        "skuSuffixes": [
          "-BLU"
        ],
        "order": 1
      }
    ]
  },
  {
    "id": "n7a1m3e5t9x2o4q6w8e0r2t4",
    "storeId": "k3m9x2p7q8r4t6v1w5y0z3a2",
    "name": "Name",
    "isPersonalization": true,
    "aliases": [
      "Personalization",
      "Name to engrave"
    ],
    "createdAt": "2026-09-23T16:21:37.806Z",
    "updatedAt": "2026-09-23T16:21:37.806Z",
    "values": []
  }
]

Response Schema

SkuOption[] | SearchResponse
Variant 1SkuOption[]
aliasesoptionalnullable
string[]
Alternate names (as the merchant typed them) that resolve to this option.
createdAtrequired
string
format: date-time
idrequired
string
pattern: ^[a-z0-9]{24}$
isPersonalizationrequired
boolean
namerequired
string
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
updatedAtrequired
string
format: date-time
Variant 2SearchResponseStandardized search response with data, metadata, and query information
datarequired
Record<string, any>[]
Array of matching entities
metarequired
object
Pagination and result metadata
countrequired
number
Number of records returned in this response
executionTimerequired
number
Query execution time in milliseconds
hasMorerequired
boolean
Whether there are more records available
limitrequired
number
Maximum number of records requested
offsetrequired
number
Number of records skipped
totalrequired
number
Total number of matching records (before pagination)

Example Response

200 OK — application/json 
[
  {
    "name": "string",
    "isPersonalization": true,
    "aliases": [
      "string"
    ],
    "id": "string",
    "storeId": "string",
    "createdAt": "2025-01-15T12:00:00.000Z",
    "updatedAt": "2025-01-15T12:00:00.000Z"
  }
]