Get variant availability by country
Variants
Get variant availability
Use this endpoint to retrieve a variant’s availability across countries. Returns an availability map keyed by ISO 3166-1 alpha-2 country code (e.g., “US”, “DE”).
Each entry includes:
isAvailable- whether the variant ships to that countryprice- variant price for that country (null if not available)priceBreakdown- full pricing detail (null if not available)
Please note
- Country codes not present in the response should be treated as
isAvailable: false- only supported countries are returned. - Unlike other variant endpoints, this endpoint does not accept a
locationparameter. It returns availability for every supported country in a single response.
Permissions
- Requires:
products:read
GET
Get variant availability by country
Authorizations
Company Level Authentication
Include your API key in the X-Api-Key header for every request:
Headers
Optional account identifier for swag validation/filtering.
Example:
"acc123456"
Optional company identifier for swag validation/filtering.
Example:
"cmp123456"
Path Parameters
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.
Availability entry for a single country.
Last modified on June 17, 2026