Skip to main content
GET
Get variant availability by country
Recommended usage pattern:
  • Subscribe to variant-availability-changed webhooks to keep your local availability state current — no polling required.
  • Call this endpoint only immediately before placing an order, as a final pre-order check that the variant is still available in the recipient’s country.
Calling this endpoint on every page load or UI render may exhaust your rate limit on busy catalog pages.

Authorizations

X-Api-Key
string
header
required

Company Level Authentication

Include your API key in the X-Api-Key header for every request:

Headers

snappy-account-id
string

Must be provided to retrieve swag products.

Example:

"acc123456"

Path Parameters

variantId
string
required

Variant ID.

Pattern: ^(?:^[A-Za-z0-9]{8,}$|^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$)$
Example:

"FB6bgFV4lf"

Response

Availability map keyed by ISO 3166-1 alpha-2 country code.

Map keyed by ISO 3166-1 alpha-2 country code. Missing countries should be treated as unavailable.

{key}
object

Availability entry for a single country.

Last modified on October 7, 2026