curl --request GET \
--url https://api.snappy.com/v3/variants/{variantId} \
--header 'X-Api-Key: <api-key>'{
"id": "f6g7h8i9j0",
"title": "$10 Gift Card",
"selectedOptions": {
"denomination": "$10"
},
"taxable": true,
"media": [
{
"type": "image",
"src": "https://media.snappy.com/image/asset123?w=1000&h=1000&q=80&f=auto"
}
],
"productId": "a1b2c3d4e5",
"price": {
"amount": 10,
"currency": "usd"
},
"priceBreakdown": {
"ddp": 0,
"shippingFee": 2.5,
"itemPrice": 43.2
},
"details": {
"descriptionHtml": "<p>Digital gift card redeemable online.</p>",
"includes": "<p>Charger, cable, earphones</p>",
"features": "<string>",
"specifications": {
"material": "cotton",
"dimensions": "10x20"
},
"notices": {
"prop65Warning": "This product contains chemicals known to the State of California to cause cancer."
}
},
"brand": {
"id": "621f9d4b1e675adcbc196159",
"name": "Apple",
"description": "Cute pet brand"
},
"personalization": {
"isPersonalized": true,
"personalizationTemplateFields": [
"firstName",
"lastName",
"department"
]
}
}Retrieves a single variant by its id (SnappyProduct._id). Returns
the same Variant shape as items in GET /v3/products/{productId}/variants.
Use fields=pricing,details,brand (or fields=full) to request
variant-level expansions. When fields is omitted, price,
priceBreakdown, and details are not returned.
curl --request GET \
--url https://api.snappy.com/v3/variants/{variantId} \
--header 'X-Api-Key: <api-key>'{
"id": "f6g7h8i9j0",
"title": "$10 Gift Card",
"selectedOptions": {
"denomination": "$10"
},
"taxable": true,
"media": [
{
"type": "image",
"src": "https://media.snappy.com/image/asset123?w=1000&h=1000&q=80&f=auto"
}
],
"productId": "a1b2c3d4e5",
"price": {
"amount": 10,
"currency": "usd"
},
"priceBreakdown": {
"ddp": 0,
"shippingFee": 2.5,
"itemPrice": 43.2
},
"details": {
"descriptionHtml": "<p>Digital gift card redeemable online.</p>",
"includes": "<p>Charger, cable, earphones</p>",
"features": "<string>",
"specifications": {
"material": "cotton",
"dimensions": "10x20"
},
"notices": {
"prop65Warning": "This product contains chemicals known to the State of California to cause cancer."
}
},
"brand": {
"id": "621f9d4b1e675adcbc196159",
"name": "Apple",
"description": "Cute pet brand"
},
"personalization": {
"isPersonalized": true,
"personalizationTemplateFields": [
"firstName",
"lastName",
"department"
]
}
}Documentation Index
Fetch the complete documentation index at: https://docs.snappy.com/llms.txt
Use this file to discover all available pages before exploring further.
Partner API key. Finalized per partner integration agreement.
Optional account identifier for swag validation/filtering.
Variant identifier (SnappyProduct._id).
ISO 3166-1 alpha-2 country code (default US).
^[A-Z]{2}$Comma-separated list of variant-level field expansions.
pricing — includes price and priceBreakdown.details — includes the variant details wrapper.brand — includes the variant's brand object.full — every field above.When omitted, price, priceBreakdown, and details are not
returned.
pricing, details, brand, full Single variant.
A single variant. price, priceBreakdown, details, and brand
are returned only when requested via fields on variant endpoints.
"f6g7h8i9j0"
"$10 Gift Card"
This variant's selected option values
(e.g. { "color": "Black", "size": "S" }).
Show child attributes
{ "denomination": "$10" }true
Variant media items. Array order defines display order.
Show child attributes
Parent product (VariationGroup) identifier.
"a1b2c3d4e5"
Variant price in a given currency.
Show child attributes
Detailed breakdown of the variant price.
Show child attributes
Variant-level descriptive content (details wrapper). Returned only
when requested via fields=details on variant endpoints. Not
returned on list / export endpoints.
Show child attributes
Returned when fields includes brand on variant endpoints.
Show child attributes
null when the variant is not personalizable.
Show child attributes
Was this page helpful?