Subscription Data
Get variant contextual pricing
Retrieves contextual pricing information for a product variant based on currency and country. This endpoint provides localized pricing data for international subscriptions and multi-currency support.
Pricing Information Returned:
- Base price in specified currency
- Compare-at price (if applicable)
- Country-specific pricing adjustments
- Tax information for the region
- Currency conversion data
Parameters:
variantId- Shopify variant ID (required)currencyCode- ISO 4217 currency code (e.g., USD, EUR, GBP) (required)countryCode- ISO 3166-1 country code (e.g., US, GB, CA) (optional)
Use Cases:
- Display localized pricing in customer portal
- Calculate subscription totals for international customers
- Support multi-currency subscriptions
- Show accurate pricing based on customer location
- Validate pricing before subscription creation
Important Notes:
- Requires Shopify Markets or multi-currency setup
- Prices are returned in the requested currency
- Country-specific pricing takes precedence over currency-only pricing
- Returns 404 if variant doesn’t exist or isn’t available in specified market
Authentication: Requires valid api_key parameter
GET
/
subscriptions
/
cp
/
api
/
data
/
variant-contextual-pricing
Get variant contextual pricing
curl --request GET \
--url https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricingimport requests
url = "https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing';
const options = {method: 'GET'};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"contextualPricing": {
"get__typename": "<string>",
"price": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
}
},
"get__typename": "<string>",
"id": "<string>",
"media": {
"get__typename": "<string>",
"nodes": [
{
"currentPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"customAttributes": [
{
"get__typename": "<string>",
"key": "<string>",
"value": "<string>"
}
],
"discountAllocations": [
{
"amount": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"discount": {
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>",
"id": "<string>",
"lineDiscountedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"pricingPolicy": {
"basePrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"cycleDiscounts": [
{
"adjustmentType": "PERCENTAGE",
"adjustmentValue": {
"get__typename": "<string>"
},
"afterCycle": 123,
"computedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>"
},
"productId": "<string>",
"quantity": 123,
"sellingPlanId": "<string>",
"sellingPlanName": "<string>",
"sku": "<string>",
"taxable": true,
"title": "<string>",
"variantId": "<string>",
"variantImage": {
"get__typename": "<string>",
"url": {}
},
"variantTitle": "<string>"
}
]
},
"price": {},
"product": {
"get__typename": "<string>",
"handle": "<string>",
"id": "<string>",
"status": "ACTIVE",
"title": "<string>"
},
"sku": "<string>",
"title": "<string>"
}{
"contextualPricing": {
"get__typename": "<string>",
"price": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
}
},
"get__typename": "<string>",
"id": "<string>",
"media": {
"get__typename": "<string>",
"nodes": [
{
"currentPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"customAttributes": [
{
"get__typename": "<string>",
"key": "<string>",
"value": "<string>"
}
],
"discountAllocations": [
{
"amount": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"discount": {
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>",
"id": "<string>",
"lineDiscountedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"pricingPolicy": {
"basePrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"cycleDiscounts": [
{
"adjustmentType": "PERCENTAGE",
"adjustmentValue": {
"get__typename": "<string>"
},
"afterCycle": 123,
"computedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>"
},
"productId": "<string>",
"quantity": 123,
"sellingPlanId": "<string>",
"sellingPlanName": "<string>",
"sku": "<string>",
"taxable": true,
"title": "<string>",
"variantId": "<string>",
"variantImage": {
"get__typename": "<string>",
"url": {}
},
"variantTitle": "<string>"
}
]
},
"price": {},
"product": {
"get__typename": "<string>",
"handle": "<string>",
"id": "<string>",
"status": "ACTIVE",
"title": "<string>"
},
"sku": "<string>",
"title": "<string>"
}{
"contextualPricing": {
"get__typename": "<string>",
"price": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
}
},
"get__typename": "<string>",
"id": "<string>",
"media": {
"get__typename": "<string>",
"nodes": [
{
"currentPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"customAttributes": [
{
"get__typename": "<string>",
"key": "<string>",
"value": "<string>"
}
],
"discountAllocations": [
{
"amount": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"discount": {
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>",
"id": "<string>",
"lineDiscountedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"pricingPolicy": {
"basePrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"cycleDiscounts": [
{
"adjustmentType": "PERCENTAGE",
"adjustmentValue": {
"get__typename": "<string>"
},
"afterCycle": 123,
"computedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>"
},
"productId": "<string>",
"quantity": 123,
"sellingPlanId": "<string>",
"sellingPlanName": "<string>",
"sku": "<string>",
"taxable": true,
"title": "<string>",
"variantId": "<string>",
"variantImage": {
"get__typename": "<string>",
"url": {}
},
"variantTitle": "<string>"
}
]
},
"price": {},
"product": {
"get__typename": "<string>",
"handle": "<string>",
"id": "<string>",
"status": "ACTIVE",
"title": "<string>"
},
"sku": "<string>",
"title": "<string>"
}{
"contextualPricing": {
"get__typename": "<string>",
"price": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
}
},
"get__typename": "<string>",
"id": "<string>",
"media": {
"get__typename": "<string>",
"nodes": [
{
"currentPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"customAttributes": [
{
"get__typename": "<string>",
"key": "<string>",
"value": "<string>"
}
],
"discountAllocations": [
{
"amount": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"discount": {
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>",
"id": "<string>",
"lineDiscountedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"pricingPolicy": {
"basePrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"cycleDiscounts": [
{
"adjustmentType": "PERCENTAGE",
"adjustmentValue": {
"get__typename": "<string>"
},
"afterCycle": 123,
"computedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>"
},
"productId": "<string>",
"quantity": 123,
"sellingPlanId": "<string>",
"sellingPlanName": "<string>",
"sku": "<string>",
"taxable": true,
"title": "<string>",
"variantId": "<string>",
"variantImage": {
"get__typename": "<string>",
"url": {}
},
"variantTitle": "<string>"
}
]
},
"price": {},
"product": {
"get__typename": "<string>",
"handle": "<string>",
"id": "<string>",
"status": "ACTIVE",
"title": "<string>"
},
"sku": "<string>",
"title": "<string>"
}⌘I
Get variant contextual pricing
curl --request GET \
--url https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricingimport requests
url = "https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing';
const options = {method: 'GET'};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}require 'uri'
require 'net/http'
url = URI("https://www.myshop.com/apps/subscriptions/cp/api/data/variant-contextual-pricing")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"contextualPricing": {
"get__typename": "<string>",
"price": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
}
},
"get__typename": "<string>",
"id": "<string>",
"media": {
"get__typename": "<string>",
"nodes": [
{
"currentPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"customAttributes": [
{
"get__typename": "<string>",
"key": "<string>",
"value": "<string>"
}
],
"discountAllocations": [
{
"amount": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"discount": {
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>",
"id": "<string>",
"lineDiscountedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"pricingPolicy": {
"basePrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"cycleDiscounts": [
{
"adjustmentType": "PERCENTAGE",
"adjustmentValue": {
"get__typename": "<string>"
},
"afterCycle": 123,
"computedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>"
},
"productId": "<string>",
"quantity": 123,
"sellingPlanId": "<string>",
"sellingPlanName": "<string>",
"sku": "<string>",
"taxable": true,
"title": "<string>",
"variantId": "<string>",
"variantImage": {
"get__typename": "<string>",
"url": {}
},
"variantTitle": "<string>"
}
]
},
"price": {},
"product": {
"get__typename": "<string>",
"handle": "<string>",
"id": "<string>",
"status": "ACTIVE",
"title": "<string>"
},
"sku": "<string>",
"title": "<string>"
}{
"contextualPricing": {
"get__typename": "<string>",
"price": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
}
},
"get__typename": "<string>",
"id": "<string>",
"media": {
"get__typename": "<string>",
"nodes": [
{
"currentPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"customAttributes": [
{
"get__typename": "<string>",
"key": "<string>",
"value": "<string>"
}
],
"discountAllocations": [
{
"amount": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"discount": {
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>",
"id": "<string>",
"lineDiscountedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"pricingPolicy": {
"basePrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"cycleDiscounts": [
{
"adjustmentType": "PERCENTAGE",
"adjustmentValue": {
"get__typename": "<string>"
},
"afterCycle": 123,
"computedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>"
},
"productId": "<string>",
"quantity": 123,
"sellingPlanId": "<string>",
"sellingPlanName": "<string>",
"sku": "<string>",
"taxable": true,
"title": "<string>",
"variantId": "<string>",
"variantImage": {
"get__typename": "<string>",
"url": {}
},
"variantTitle": "<string>"
}
]
},
"price": {},
"product": {
"get__typename": "<string>",
"handle": "<string>",
"id": "<string>",
"status": "ACTIVE",
"title": "<string>"
},
"sku": "<string>",
"title": "<string>"
}{
"contextualPricing": {
"get__typename": "<string>",
"price": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
}
},
"get__typename": "<string>",
"id": "<string>",
"media": {
"get__typename": "<string>",
"nodes": [
{
"currentPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"customAttributes": [
{
"get__typename": "<string>",
"key": "<string>",
"value": "<string>"
}
],
"discountAllocations": [
{
"amount": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"discount": {
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>",
"id": "<string>",
"lineDiscountedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"pricingPolicy": {
"basePrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"cycleDiscounts": [
{
"adjustmentType": "PERCENTAGE",
"adjustmentValue": {
"get__typename": "<string>"
},
"afterCycle": 123,
"computedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>"
},
"productId": "<string>",
"quantity": 123,
"sellingPlanId": "<string>",
"sellingPlanName": "<string>",
"sku": "<string>",
"taxable": true,
"title": "<string>",
"variantId": "<string>",
"variantImage": {
"get__typename": "<string>",
"url": {}
},
"variantTitle": "<string>"
}
]
},
"price": {},
"product": {
"get__typename": "<string>",
"handle": "<string>",
"id": "<string>",
"status": "ACTIVE",
"title": "<string>"
},
"sku": "<string>",
"title": "<string>"
}{
"contextualPricing": {
"get__typename": "<string>",
"price": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
}
},
"get__typename": "<string>",
"id": "<string>",
"media": {
"get__typename": "<string>",
"nodes": [
{
"currentPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"customAttributes": [
{
"get__typename": "<string>",
"key": "<string>",
"value": "<string>"
}
],
"discountAllocations": [
{
"amount": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"discount": {
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>",
"id": "<string>",
"lineDiscountedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"pricingPolicy": {
"basePrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"cycleDiscounts": [
{
"adjustmentType": "PERCENTAGE",
"adjustmentValue": {
"get__typename": "<string>"
},
"afterCycle": 123,
"computedPrice": {
"amount": {},
"currencyCode": "USD",
"get__typename": "<string>"
},
"get__typename": "<string>"
}
],
"get__typename": "<string>"
},
"productId": "<string>",
"quantity": 123,
"sellingPlanId": "<string>",
"sellingPlanName": "<string>",
"sku": "<string>",
"taxable": true,
"title": "<string>",
"variantId": "<string>",
"variantImage": {
"get__typename": "<string>",
"url": {}
},
"variantTitle": "<string>"
}
]
},
"price": {},
"product": {
"get__typename": "<string>",
"handle": "<string>",
"id": "<string>",
"status": "ACTIVE",
"title": "<string>"
},
"sku": "<string>",
"title": "<string>"
}