Skip to main content
GET
/
v3
/
variants
/
{variantId}
/
availability
Get variant availability by country
curl --request GET \
  --url https://api.snappy.com/v3/variants/{variantId}/availability \
  --header 'X-Api-Key: <api-key>'
{
  "US": {
    "isAvailable": true,
    "price": {
      "amount": 45.7,
      "currency": "usd"
    },
    "priceBreakdown": {
      "ddp": 0,
      "shippingFee": 2.5,
      "itemPrice": 43.2
    }
  },
  "CA": {
    "isAvailable": false,
    "price": null,
    "priceBreakdown": null
  }
}

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.

Authorizations

​
X-Api-Key
string
header
required

Partner API key. Finalized per partner integration agreement.

Headers

​
Snappy-Account-Id
string

Optional account identifier for swag validation/filtering.

Path Parameters

​
variantId
string
required

Variant identifier (SnappyProduct._id).

Response

Availability map keyed by country code.

Availability map keyed by ISO 3166-1 alpha-2 country code. Country codes not present should be treated as isAvailable: false.

​
{key}
object

Per-country availability entry. When isAvailable is false, price and priceBreakdown are null.

Last modified on May 15, 2026