Skip to main content
POST
Query Watch Variants

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
q
string

Search query to filter by SKU, vendor SKU, product title/description, brand, model, or reference number.

filter_variant_options
object

Watch attribute filters, e.g. {"brand": "Rolex"}. See /api/v3/product_filters?product_type=watch for supported keys/values.

product_id
string[]

Product ID(s) to filter by.

id
string[]

Variant ID(s) to filter by.

has_media
boolean
returnable
boolean
wholesale_price_min
number
wholesale_price_max
number
retail_price_min
number
retail_price_max
number
include_unavailable
boolean
default:false

Include sold/out-of-stock variants. Always true when id is provided.

currency_code
string
default:USD

Currency code for price conversion (e.g. USD, EUR, GBP).

offset
integer
default:0
limit
integer
default:50
order_by
string
default:created_on
order
enum<string>
default:desc
Available options:
asc,
desc

Response

200 - application/json

OK

variants
object[]
offset
integer
limit
integer
total
integer