Products
Learn how to retrieve product information.
Last updated
Was this helpful?
Learn how to retrieve product information.
Last updated
Was this helpful?
In the world of eCommerce, products are the foundation of your inventory. Each product represents an item available for purchase and includes a comprehensive set of attributes that define its characteristics, pricing, and availability. This section will cover various aspects of product management within the Commerce API, including how to effectively retrieve, list, and handle products to streamline your eCommerce operations.
When integrating with the Commerce API, retrieving product information efficiently is essential. One of the fundamental tasks is obtaining a product by its unique identifier. This section will guide you through fetching detailed product data. By following these instructions, you can ensure access to all necessary product attributes, enabling seamless eCommerce operations.
To get a product by its identifier, send a request. This request retrieves detailed information about the specified product. Replace {Your_Access_Token} and {productId} with your actual values.
curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/me/products/{productId}' \
--header 'authorization: bearer {Your_Access_token}\
...{
"product": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/8027217700",
"relation": "https://api.digitalriver.com/v1/shoppers/ProductsResource",
"categories": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/8027217700/categories",
"relation": "https://api.digitalriver.com/v1/shoppers/CategoriesResource"
},
"familyAttributes": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/8027217700/family-attributes",
"relation": "https://api.digitalriver.com/v1/shoppers/ProductsResource"
},
"id": 8027217700,
"name": "Combination Product",
"displayName": "Combination Product",
"shortDescription": null,
"longDescription": null,
"productType": "OTHER",
"sku": "Combination Product",
"externalReferenceId": null,
"companyId": "paytest",
"displayableProduct": "true",
"purchasable": "true",
"manufacturerName": null,
"manufacturerPartNumber": "1234567890",
"minimumQuantity": null,
"maximumQuantity": null,
"thumbnailImage": null,
"productImage": null,
"keywords": null,
"baseProduct": "false",
"pricing": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/8027217700/pricing",
"listPrice": {
"currency": "USD",
"value": 45
},
"salePriceWithQuantity": {
"currency": "USD",
"value": 36
},
"formattedListPrice": "$45.00",
"formattedSalePriceWithQuantity": "$36.00",
"listPriceIncludesTax": "false",
"msrpPrice": null,
"formattedMsrpPrice": null
},
"addProductToCart": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/line-items?productId=8027217700",
"relation": "https://api.digitalriver.com/v1/shoppers/LineItemsResource",
"cartUri": "https://api.digitalriver.com/v1/shoppers/me/carts/active?productId=8027217700"
},
"components": [
{
"product": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/257734900",
"relation": "https://api.digitalriver.com/v1/shoppers/ProductsResource"
},
"categories": {
"uri": "https://api.digitalriver.com/api/v1/shoppers/me/products/257734900/categories",
"relation": "https://api.digitalriver.com/v1/shoppers/CategoriesResource"
},
"familyAttributes": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/257734900/family-attributes",
"relation": "https://api.digitalriver.com/v1/shoppers/ProductsResource"
},
"id": 257734900,
"name": "Free trial product",
"displayName": "Free trial product",
"shortDescription": null,
"longDescription": null,
"productType": "DOWNLOAD",
"sku": "asdf",
"externalReferenceId": null,
"companyId": "paytest",
"displayableProduct": "true",
"purchasable": "true",
"manufacturerName": null,
"manufacturerPartNumber": "asdf",
"minimumQuantity": null,
"maximumQuantity": null,
"thumbnailImage": null,
"productImage": null,
"keywords": null,
"baseProduct": "false",
"pricing": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/257734900/pricing",
"listPrice": {
"currency": "USD",
"value": 9
},
"salePriceWithQuantity": {
"currency": "USD",
"value": 0
},
"formattedListPrice": "$9.00",
"formattedSalePriceWithQuantity": "$0.00",
"listPriceIncludesTax": "false",
"msrpPrice": null,
"formattedMsrpPrice": null
},
"addProductToCart": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/line-items?productId=257734900",
"relation": "https://api.digitalriver.com/v1/shoppers/LineItemsResource",
"cartUri": "https://api.digitalriver.com/v1/shoppers/me/carts/active?productId=257734900"
},
"recurringSubscriptionInfo": {
"autoRenewal": "true",
"termUnit": "WEEK",
"termLength": "1"
}
},
{
"product": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/5505627700",
"relation": "https://api.digitalriver.com/v1/shoppers/ProductsResource"
},
"categories": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/5505627700/categories",
"relation": "https://api.digitalriver.com/v1/shoppers/CategoriesResource"
},
"familyAttributes": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/5505627700/family-attributes",
"relation": "https://api.digitalriver.com/v1/shoppers/ProductsResource"
},
"id": 5505627700,
"name": "AK123_Physical",
"displayName": "AK123_Physical",
"shortDescription": null,
"longDescription": null,
"productType": "PHYSICAL",
"sku": "AK123_Physical",
"externalReferenceId": null,
"companyId": "paytest",
"displayableProduct": "true",
"purchasable": "true",
"manufacturerName": null,
"manufacturerPartNumber": "MSTS321",
"minimumQuantity": null,
"maximumQuantity": null,
"thumbnailImage": null,
"productImage": null,
"keywords": null,
"baseProduct": "false",
"pricing": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/5505627700/pricing",
"listPrice": {
"currency": "USD",
"value": 17
},
"salePriceWithQuantity": {
"currency": "USD",
"value": 17
},
"formattedListPrice": "$17.00",
"formattedSalePriceWithQuantity": "$17.00",
"listPriceIncludesTax": "false",
"msrpPrice": null,
"formattedMsrpPrice": null
},
"addProductToCart": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/line-items?productId=5505627700",
"relation": "https://api.digitalriver.com/v1/shoppers/LineItemsResource",
"cartUri": "https://api.digitalriver.com/v1/shoppers/me/carts/active?productId=5505627700"
}
},
{
"product": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/6686217700",
"relation": "https://api.digitalriver.com/v1/shoppers/ProductsResource"
},
"categories": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/6686217700/categories",
"relation": "https://api.digitalriver.comm/v1/shoppers/CategoriesResource"
},
"familyAttributes": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/6686217700/family-attributes",
"relation": "https://api.digitalriver.com/v1/shoppers/ProductsResource"
},
"id": 6686217700,
"name": "Auto_Monthly_Sub",
"displayName": "Auto_Monthly_Sub",
"shortDescription": null,
"longDescription": null,
"productType": "DOWNLOAD",
"sku": "Auto_Monthly_Sub",
"externalReferenceId": null,
"companyId": "paytest",
"displayableProduct": "true",
"purchasable": "true",
"manufacturerName": null,
"manufacturerPartNumber": "12345678",
"minimumQuantity": null,
"maximumQuantity": null,
"thumbnailImage": null,
"productImage": null,
"keywords": null,
"baseProduct": "false",
"pricing": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/6686217700/pricing",
"listPrice": {
"currency": "USD",
"value": 19
},
"salePriceWithQuantity": {
"currency": "USD",
"value": 19
},
"formattedListPrice": "$19.00",
"formattedSalePriceWithQuantity": "$19.00",
"listPriceIncludesTax": "false",
"msrpPrice": null,
"formattedMsrpPrice": null
},
"addProductToCart": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/line-items?productId=6686217700",
"relation": "https://api.digitalriver.com/v1/shoppers/LineItemsResource",
"cartUri": "https://api.digitalriver.com/v1/shoppers/me/carts/active?productId=6686217700"
},
"recurringSubscriptionInfo": {
"autoRenewal": "true",
"termUnit": "MONTH",
"termLength": "1"
}
}
]
}
}A 200 OK response indicates that the request was successful, and the server returned the requested data. Your GET request to fetch the product information was processed correctly, and you received the relevant product details in the response body.
Understanding volume pricing is crucial for optimizing sales and offering customers attractive discounts when managing eCommerce pricing. The Commerce API allows you to retrieve tailored volume pricing for specific products. This section will guide you through fetching volume pricing details. By following these instructions, you can efficiently access and display volume-based pricing information, enhancing your product offerings and promotional strategies.
To get volume pricing for a specific product, send a request. Replace {Your_Access_Token} and {productId} with your actual values.
curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/me/products/{productId}/pricing/volume-pricing' \
--header 'authorization: bearer {Your_Access_token}'{
"volumePricing": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/73248500/pricing/volume-pricing",
"tier": [
{
"from": 1,
"to": 1,
"pricing": {
"listPrice": {
"currency": "USD",
"value": "19.99"
},
"listPriceWithQuantity": {
"currency": "USD",
"value": "19.99"
},
"salePriceWithQuantity": {
"currency": "USD",
"value": "19.99"
},
"formattedListPrice": "$8.00",
"formattedListPriceWithQuantity": "$8.00",
"formattedSalePriceWithQuantity": "$8.00",
"totalDiscountWithQuantity": {
"currency": "USD",
"value": "19.99"
},
"formattedTotalDiscountWithQuantity": "$0.00",
"discountDescription": "string",
"feePricing": {
"salePriceWithFeesAndQuantity": {
"currency": "USD",
"value": "19.99"
},
"formattedSalePriceWithFeesAndQuantity": "$8.00"
},
"listPriceIncludesTax": "false",
"msrpPrice": {
"currency": "USD",
"value": "19.99"
},
"formattedMsrpPrice": "string"
}
}
],
"formattedSalesPriceRange": "$5.00-$8.00"
}
}A 200 OK response means the request was successful, and the server returned the requested data. Your GET request to retrieve the volume pricing information for a specific product was processed correctly, and you received the relevant volume pricing details in the response body.
Retrieving the complete product catalog lets you offer your customers a comprehensive view of all available products. This can enhance the shopping experience by ensuring shoppers can access your store's products. The following instructions will guide you through fetching all products from your product catalog using the Commerce API.
curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/me/products' \
--header 'authorization: bearer {Your_Access_token}'{
"products": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products",
"nextPage": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products?pageNumber=11&pageSize=1"
},
"previousPage": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products?pageNumber=9&pageSize=1"
},
"product": [
{
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/73248400",
"displayName": "Class VI",
"thumbnailImage": "https://drh-sys-ora.img.digitalriver.com/Storefront/Company/demosft3/images/product/thumbnail/classVIThumb.jpg",
"pricing": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/73248400/pricing",
"formattedListPrice": "$79.99",
"formattedSalePriceWithQuantity": "$79.99"
},
"addProductToCart": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/line-items?productId=73248400",
"cartUri": "https://api.digitalriver.com/v1/shoppers/me/carts/active?productId=73248400"
}
}
],
"totalResults": 11,
"totalResultPages": 11
}
}A 200 OK response indicates that the request was successful and returns the product catalog information in the response body.
You may often need to retrieve all products within a specific category to enhance user experience and streamline product searches. The following instructions will guide you through fetching all products for a specified category using the Commerce API. This ensures that customers can easily discover and explore products that meet their needs.
curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/me/categories/{categoryId}/products' \
--header 'authorization: bearer {Your_Access_token}\
...{
"products": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products",
"product": [
{
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/64358200",
"displayName": "Class I",
"thumbnailImage": "https://drh-sys-ora.img.digitalriver.com/Storefront/Company/demosft1/images/product/thumbnail/classIThumb_v2.jpg",
"pricing": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/64358200/pricing",
"formattedListPrice": "$19.99",
"formattedSalePriceWithQuantity": "$18.99"
},
"variations": {
"uri": "https://api.digitalriver.com/v1/shoppers/me/products/64358200/variations"
}
}
],
"totalResults": 1,
"totalResultPages": 1
}
}A 200 OK response indicates that the request was successful and returns the product category information in the response body.
The following example gets a specific base or individual product with a productId.
curl --location --request GET 'https://api.digitalriver.com/v1/products/{productId}' \
--header 'Authorization: Basic {your_API_key}' \
...An ERID request requires the x-erid-as-pid=true header.
curl --location --request GET 'https://api.digitalriver.com/v1/products/{ERID}' \
--header 'Authorization: Basic {your_API_key}' \
--header 'header x-erid-as-pid=true' \
...The request returns the product information for the specified productId in the synchronous response.
[
{
"productType": "BASE",
"companyId": "digitalriver",
"siteIds": [
"domoSite1",
"domoSite2"
],
"id": 1234567800,
"state": "Deployed",
"locked": false,
"version": 1,
"deploymentRequiredChanges": {
"fulfillmentTypes": [
"Download"
],
"otherFulfillmentIntegration": {
"fulfillerIds": [
"digitalRiver"
]
},
"transferProduct": 2234567800,
"upgradeProducts": [
3234567800
],
"downgradeProducts": [
4234567800
]
},
"liveChanges": {
"externalReferenceId": "sku-1234-5678-xyz",
"catalogs": [
{
"catalogId": 123456000,
"catalogName": "a catalog",
"categories": [
{
"categoryId": 19000000,
"categoryName": "a category"
}
],
"prices": [
{
"type": "listPrice",
"priceListName": "Unit Price",
"taxInclusive": true,
"prices": [
{
"currency": "USD",
"locale": "en_US",
"configuredPrice": 15.99,
"calculatedPrice": 0
}
]
}
]
}
]
},
"localizations": [
{
"locale": "en_US",
"isDefault": true,
"groups": [
{
"groupId": 11000,
"groupName": "Storefront Settings",
"attributes": {
"property1": "string",
"property2": "string"
}
}
]
}
]
}
]The request returns the product information for the specified externalReferenceId in the synchronous response.
[
{
"productType": "INDIVIDUAL",
"companyId": "acme",
"siteIds": [
"acme"
],
"id": "51954990080",
"state": "DESIGN",
"locked": false,
"version": 1,
"deploymentRequiredChanges": {
"fulfillmentTypes": [],
"otherFulfillmentIntegration": {
"fulfillerIds": []
},
"upgradeProducts": [],
"downgradeProducts": []
},
"liveChanges": {
"externalReferenceId": "external-reference-id-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"catalogs": [
{
"catalogId": "4783669800",
"catalogName": "acme",
"categories": [],
"pricing": [
{
"type": "listPrice",
"priceListName": "acme",
"taxInclusive": false,
"prices": [
{
"currency": "CAD",
"locale": "en_CA"
},
{
"currency": "CAD",
"locale": "en_US"
},
{
"currency": "USD",
"locale": "en_US",
"configuredPrice": 10.00
},
{
"currency": "CAD",
"locale": "fr_CA"
},
{
"currency": "ARS"
},
{
"currency": "AUD"
},
{
"currency": "BRL"
},
{
"currency": "CAD"
},
{
"currency": "CHF"
},
{
"currency": "CLP"
},
{
"currency": "CNY"
},
{
"currency": "COP"
},
{
"currency": "CZK"
},
{
"currency": "DKK"
},
{
"currency": "EGP"
},
{
"currency": "EUR"
},
{
"currency": "GBP"
},
{
"currency": "HKD"
},
{
"currency": "HUF"
},
{
"currency": "IDR"
},
{
"currency": "ILS"
},
{
"currency": "INR"
},
{
"currency": "JPY"
},
{
"currency": "KRW"
},
{
"currency": "MXN"
},
{
"currency": "MYR"
},
{
"currency": "NOK"
},
{
"currency": "NZD"
},
{
"currency": "OMR"
},
{
"currency": "PEN"
},
{
"currency": "PLN"
},
{
"currency": "RUB"
},
{
"currency": "SEK"
},
{
"currency": "SGD"
},
{
"currency": "THB"
},
{
"currency": "TRY"
},
{
"currency": "TWD"
},
{
"currency": "USD"
},
{
"currency": "VEF"
},
{
"currency": "ZAR"
}
]
},
{
"type": "subscriptionRenewalPrice",
"priceListName": "Subscription Renewal Price list",
"taxInclusive": false,
"prices": [
{
"currency": "ARS"
},
{
"currency": "EUR"
},
{
"currency": "GBP"
},
{
"currency": "USD"
}
]
}
]
}
]
},
"localizations": [
{
"locale": "en_US",
"isDefault": true,
"groups": [
{
"groupId": "2",
"groupName": "Storefront Settings",
"attributes": {
"longDescription": "longDescription-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"nonSolr": true,
"keywords": "keywords-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"displayName": "demo-display-name-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"taxableUnspscCode": "43230000",
"confirmAddlInfo": "confirmAddlInfo-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"shortDescription": "shortDescription-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"isViewable": true,
"taxableProductCode": "4323.320_D",
"isOrderable": true,
"returnMethod": "LOD",
"emailAddlInfoText": "emailAddlInfoText-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"name": "demo-name-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"emailAddlInfo": "emailAddlInfo-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"minOrderQuantity": 0,
"privateStoreOnly": false,
"productReturnMethod": "ByAgentAndSelfService",
"sku": "demo-sku-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"maxOrderQuantity": 0
}
},
{
"groupId": "10",
"groupName": "Subscription",
"attributes": {
"freeExtension": "2_WEEK",
"timeIntervalForTrialReminderNotifications": [
"30",
"15",
"7",
"2"
],
"gracePeriod": "1_WEEK",
"timeIntervalForUpgradeReminderNotificationsPostCreation": [
"7",
"15",
"30",
"90"
],
"timeIntervalForReminderNotifications": [
"90",
"30",
"15",
"7"
],
"suppressOFIInQuantityIncrease": false,
"suppressDRMInUpgradeDowngrade": false,
"suppressOFIInUpgradeDowngrade": false,
"suppressDRMInQuantityIncrease": false,
"timeIntervalForReminderNotificationsPostExpiration": [
"7",
"15",
"30",
"90"
],
"autoRenewalDateBasis": "PurchaseDate",
"timeIntervalForUpgradeReminderNotificationsPreExpiration": [
"97",
"37",
"22",
"14"
],
"isFreeTrial": true,
"combinedRenewalPeriod": 1,
"timeIntervalForCCExpirationReminderNotifications": [
"30",
"15",
"7"
],
"duration": "TWO_MONTH",
"timeIntervalForManualReminderNotifications": [
"90",
"30",
"15",
"7"
],
"isDistinctScheduleTurnedOn": false,
"isCombinedRenewal": true,
"suppressDRMInRenewal": false,
"paymentSchedule": "matchRecurrence",
"isAutomatic": true,
"numOfDaysPriorExpirationForRenewalPreFirst": 30,
"isChangeProductAsRenewal": false,
"freeTrialPeriod": 45,
"includeRenewalProductInUpgradeList": true,
"numOfDaysPriorExpirationForRenewal": 4,
"suppressOFIInTrialConversion": true,
"numOfDaysPriorExpirationForRenewalFirst": 15,
"timeIntervalForUpgradeReminderNotificationsPostExpiration": [
"97",
"37",
"22",
"14"
],
"postExpirationBillingAttemptIntervalInDays": 7,
"suppressOFIInRenewal": true,
"suppressDRMInTrialConversion": false,
"trialPostExpirationBillingAttemptIntervalInDays": 7,
"trialGracePeriod": "1_MONTH",
"timeIntervalForTrialManualReminderNotifications": [
"30",
"15",
"7",
"2"
]
}
},
{
"groupId": "16",
"groupName": "Export Controls",
"attributes": {
"manufactureCountry": "US",
"eccn": "3A992"
}
}
]
}
]
}
]The Commerce API provides convenient query parameters to retrieve specific product versions, such as the deployed or retired versions. By specifying version=RETIRED or version=DEPLOYED you can access detailed information about these product states in your request URL. This functionality helps you effectively manage and review different product lifecycle stages. For ERID requests, ensure you include the x-erid-as-pid=true header for accurate retrieval.
The following example gets retired versions of a specific product with a productId.
curl --location --request GET 'https://api.digitalriver.com/v1/products/{productId}?version=RETIRED' \
--header 'Authorization: Basic {your_API_key}' \
...An ERID request requires the x-erid-as-pid=true header.
curl --location --request GET 'https://api.digitalriver.com/v1/products/{ERID}?version=RETIRED' \
--header 'Authorization: Basic <{your_API_key}' \
--header 'header x-erid-as-pid=true' \
...The request returns the product information for the specified productId in the synchronous response.
[
{
"productType": "INDIVIDUAL",
"companyId": "acme",
"siteIds": [
"acme"
],
"id": "51954990080",
"state": "RETIRED",
"locked": false,
"version": 1,
"deploymentRequiredChanges": {
"fulfillmentTypes": [],
"otherFulfillmentIntegration": {
"fulfillerIds": []
},
"upgradeProducts": [],
"downgradeProducts": []
},
"liveChanges": {
"externalReferenceId": "external-reference-id-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"catalogs": [
{
"catalogId": "4783669800",
"catalogName": "acme",
"categories": [],
"pricing": [
{
"type": "listPrice",
"priceListName": "acme",
"taxInclusive": false,
"prices": [
{
"currency": "CAD",
"locale": "en_CA"
},
{
"currency": "CAD",
"locale": "en_US"
},
{
"currency": "USD",
"locale": "en_US",
"configuredPrice": 10.00
},
{
"currency": "CAD",
"locale": "fr_CA"
},
{
"currency": "ARS"
},
{
"currency": "AUD"
},
{
"currency": "BRL"
},
{
"currency": "CAD"
},
{
"currency": "CHF"
},
{
"currency": "CLP"
},
{
"currency": "CNY"
},
{
"currency": "COP"
},
{
"currency": "CZK"
},
{
"currency": "DKK"
},
{
"currency": "EGP"
},
{
"currency": "EUR"
},
{
"currency": "GBP"
},
{
"currency": "HKD"
},
{
"currency": "HUF"
},
{
"currency": "IDR"
},
{
"currency": "ILS"
},
{
"currency": "INR"
},
{
"currency": "JPY"
},
{
"currency": "KRW"
},
{
"currency": "MXN"
},
{
"currency": "MYR"
},
{
"currency": "NOK"
},
{
"currency": "NZD"
},
{
"currency": "OMR"
},
{
"currency": "PEN"
},
{
"currency": "PLN"
},
{
"currency": "RUB"
},
{
"currency": "SEK"
},
{
"currency": "SGD"
},
{
"currency": "THB"
},
{
"currency": "TRY"
},
{
"currency": "TWD"
},
{
"currency": "USD"
},
{
"currency": "VEF"
},
{
"currency": "ZAR"
}
]
},
{
"type": "subscriptionRenewalPrice",
"priceListName": "Subscription Renewal Price list",
"taxInclusive": false,
"prices": [
{
"currency": "ARS"
},
{
"currency": "EUR"
},
{
"currency": "GBP"
},
{
"currency": "USD"
}
]
}
]
}
]
},
"localizations": [
{
"locale": "en_US",
"isDefault": true,
"groups": [
{
"groupId": "2",
"groupName": "Storefront Settings",
"attributes": {
"longDescription": "longDescription-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"nonSolr": true,
"keywords": "keywords-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"displayName": "demo-display-name-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"taxableUnspscCode": "43230000",
"confirmAddlInfo": "confirmAddlInfo-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"shortDescription": "shortDescription-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"isViewable": true,
"taxableProductCode": "4323.320_D",
"isOrderable": true,
"returnMethod": "LOD",
"emailAddlInfoText": "emailAddlInfoText-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"name": "demo-name-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"emailAddlInfo": "emailAddlInfo-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"minOrderQuantity": 0,
"privateStoreOnly": false,
"productReturnMethod": "ByAgentAndSelfService",
"sku": "demo-sku-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"maxOrderQuantity": 0
}
},
{
"groupId": "10",
"groupName": "Subscription",
"attributes": {
"freeExtension": "2_WEEK",
"timeIntervalForTrialReminderNotifications": [
"30",
"15",
"7",
"2"
],
"gracePeriod": "1_WEEK",
"timeIntervalForUpgradeReminderNotificationsPostCreation": [
"7",
"15",
"30",
"90"
],
"timeIntervalForReminderNotifications": [
"90",
"30",
"15",
"7"
],
"suppressOFIInQuantityIncrease": false,
"suppressDRMInUpgradeDowngrade": false,
"suppressOFIInUpgradeDowngrade": false,
"suppressDRMInQuantityIncrease": false,
"timeIntervalForReminderNotificationsPostExpiration": [
"7",
"15",
"30",
"90"
],
"autoRenewalDateBasis": "PurchaseDate",
"timeIntervalForUpgradeReminderNotificationsPreExpiration": [
"97",
"37",
"22",
"14"
],
"isFreeTrial": true,
"combinedRenewalPeriod": 1,
"timeIntervalForCCExpirationReminderNotifications": [
"30",
"15",
"7"
],
"duration": "TWO_MONTH",
"timeIntervalForManualReminderNotifications": [
"90",
"30",
"15",
"7"
],
"isDistinctScheduleTurnedOn": false,
"isCombinedRenewal": true,
"suppressDRMInRenewal": false,
"paymentSchedule": "matchRecurrence",
"isAutomatic": true,
"numOfDaysPriorExpirationForRenewalPreFirst": 30,
"isChangeProductAsRenewal": false,
"freeTrialPeriod": 45,
"includeRenewalProductInUpgradeList": true,
"numOfDaysPriorExpirationForRenewal": 4,
"suppressOFIInTrialConversion": true,
"numOfDaysPriorExpirationForRenewalFirst": 15,
"timeIntervalForUpgradeReminderNotificationsPostExpiration": [
"97",
"37",
"22",
"14"
],
"postExpirationBillingAttemptIntervalInDays": 7,
"suppressOFIInRenewal": true,
"suppressDRMInTrialConversion": false,
"trialPostExpirationBillingAttemptIntervalInDays": 7,
"trialGracePeriod": "1_MONTH",
"timeIntervalForTrialManualReminderNotifications": [
"30",
"15",
"7",
"2"
]
}
},
{
"groupId": "16",
"groupName": "Export Controls",
"attributes": {
"manufactureCountry": "US",
"eccn": "3A992"
}
}
]
}
]
}
]The following example gets deployed versions of a specified product with a productId.
curl --location --request GET 'https://api.digitalriver.com/v1/products/[productId}?version=DEPLOYED' \
--header 'Authorization: Basic {your_API_key}' \
...An ERID request requires the x-erid-as-pid=true header.
curl --location --request POST 'https://api.digitalriver.com/v1/products/{ERID}?version=DEPLOYED' \
--header 'Authorization: Basic {your_API_key}' \
--header 'header x-erid-as-pid=true' \
...The response displays the deployed version of the product.
[
{
"productType": "INDIVIDUAL",
"companyId": "acme",
"siteIds": [
"acme"
],
"id": "51954990080",
"state": "DEPLOYED",
"locked": false,
"version": 1,
"deploymentRequiredChanges": {
"fulfillmentTypes": [],
"otherFulfillmentIntegration": {
"fulfillerIds": []
},
"upgradeProducts": [],
"downgradeProducts": []
},
"liveChanges": {
"externalReferenceId": "external-reference-id-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"catalogs": [
{
"catalogId": "4783669800",
"catalogName": "acme",
"categories": [],
"pricing": [
{
"type": "listPrice",
"priceListName": "acme",
"taxInclusive": false,
"prices": [
{
"currency": "CAD",
"locale": "en_CA"
},
{
"currency": "CAD",
"locale": "en_US"
},
{
"currency": "USD",
"locale": "en_US",
"configuredPrice": 10.00
},
{
"currency": "CAD",
"locale": "fr_CA"
},
{
"currency": "ARS"
},
{
"currency": "AUD"
},
{
"currency": "BRL"
},
{
"currency": "CAD"
},
{
"currency": "CHF"
},
{
"currency": "CLP"
},
{
"currency": "CNY"
},
{
"currency": "COP"
},
{
"currency": "CZK"
},
{
"currency": "DKK"
},
{
"currency": "EGP"
},
{
"currency": "EUR"
},
{
"currency": "GBP"
},
{
"currency": "HKD"
},
{
"currency": "HUF"
},
{
"currency": "IDR"
},
{
"currency": "ILS"
},
{
"currency": "INR"
},
{
"currency": "JPY"
},
{
"currency": "KRW"
},
{
"currency": "MXN"
},
{
"currency": "MYR"
},
{
"currency": "NOK"
},
{
"currency": "NZD"
},
{
"currency": "OMR"
},
{
"currency": "PEN"
},
{
"currency": "PLN"
},
{
"currency": "RUB"
},
{
"currency": "SEK"
},
{
"currency": "SGD"
},
{
"currency": "THB"
},
{
"currency": "TRY"
},
{
"currency": "TWD"
},
{
"currency": "USD"
},
{
"currency": "VEF"
},
{
"currency": "ZAR"
}
]
},
{
"type": "subscriptionRenewalPrice",
"priceListName": "Subscription Renewal Price list",
"taxInclusive": false,
"prices": [
{
"currency": "ARS"
},
{
"currency": "EUR"
},
{
"currency": "GBP"
},
{
"currency": "USD"
}
]
}
]
}
]
},
"localizations": [
{
"locale": "en_US",
"isDefault": true,
"groups": [
{
"groupId": "2",
"groupName": "Storefront Settings",
"attributes": {
"longDescription": "longDescription-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"nonSolr": true,
"keywords": "keywords-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"displayName": "demo-display-name-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"taxableUnspscCode": "43230000",
"confirmAddlInfo": "confirmAddlInfo-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"shortDescription": "shortDescription-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"isViewable": true,
"taxableProductCode": "4323.320_D",
"isOrderable": true,
"returnMethod": "LOD",
"emailAddlInfoText": "emailAddlInfoText-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"name": "demo-name-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"emailAddlInfo": "emailAddlInfo-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"minOrderQuantity": 0,
"privateStoreOnly": false,
"productReturnMethod": "ByAgentAndSelfService",
"sku": "demo-sku-f7f6dcdc-a9dd-47c6-97fd-ffb340bcd399",
"maxOrderQuantity": 0
}
},
{
"groupId": "10",
"groupName": "Subscription",
"attributes": {
"freeExtension": "2_WEEK",
"timeIntervalForTrialReminderNotifications": [
"30",
"15",
"7",
"2"
],
"gracePeriod": "1_WEEK",
"timeIntervalForUpgradeReminderNotificationsPostCreation": [
"7",
"15",
"30",
"90"
],
"timeIntervalForReminderNotifications": [
"90",
"30",
"15",
"7"
],
"suppressOFIInQuantityIncrease": false,
"suppressDRMInUpgradeDowngrade": false,
"suppressOFIInUpgradeDowngrade": false,
"suppressDRMInQuantityIncrease": false,
"timeIntervalForReminderNotificationsPostExpiration": [
"7",
"15",
"30",
"90"
],
"autoRenewalDateBasis": "PurchaseDate",
"timeIntervalForUpgradeReminderNotificationsPreExpiration": [
"97",
"37",
"22",
"14"
],
"isFreeTrial": true,
"combinedRenewalPeriod": 1,
"timeIntervalForCCExpirationReminderNotifications": [
"30",
"15",
"7"
],
"duration": "TWO_MONTH",
"timeIntervalForManualReminderNotifications": [
"90",
"30",
"15",
"7"
],
"isDistinctScheduleTurnedOn": false,
"isCombinedRenewal": true,
"suppressDRMInRenewal": false,
"paymentSchedule": "matchRecurrence",
"isAutomatic": true,
"numOfDaysPriorExpirationForRenewalPreFirst": 30,
"isChangeProductAsRenewal": false,
"freeTrialPeriod": 45,
"includeRenewalProductInUpgradeList": true,
"numOfDaysPriorExpirationForRenewal": 4,
"suppressOFIInTrialConversion": true,
"numOfDaysPriorExpirationForRenewalFirst": 15,
"timeIntervalForUpgradeReminderNotificationsPostExpiration": [
"97",
"37",
"22",
"14"
],
"postExpirationBillingAttemptIntervalInDays": 7,
"suppressOFIInRenewal": true,
"suppressDRMInTrialConversion": false,
"trialPostExpirationBillingAttemptIntervalInDays": 7,
"trialGracePeriod": "1_MONTH",
"timeIntervalForTrialManualReminderNotifications": [
"30",
"15",
"7",
"2"
]
}
},
{
"groupId": "16",
"groupName": "Export Controls",
"attributes": {
"manufactureCountry": "US",
"eccn": "3A992"
}
}
]
}
]
}
]See the version query parameter for more information.
The version string gets the specific version of the product by state. The enums are DEPLOYED and RETIRED. If you do not specify the version query parameter, the response will contain the latest version. For example, if the product history is as follows:
Version 1 is retired: This product version is retired. Shoppers can no longer see or purchase this product in the store.
Version 2 is deployed: This product version is available in the store. Shoppers can see and purchase this product from your store.
Version 3 is in design: This new product version is not yet available in the store, but you plan to deploy this new version eventually. Shoppers cannot see or purchase this product from your store.
Use the following calls can get the different versions:
If you want to get the retired version (version 1), use the following call: GET /v1/products/{productId}?version=retired
If you want to get the deployed version (version 2), use the following call: GET /v1/products/{productId}?version=deployed
If you want to get the latest unreleased version, use the following call: GET /v1/products/{productId}
To retrieve all products from the product catalog, send a request. Replace {Your_Access_token} with your actual access token.
Send a request, replacing {categoryId} with the actual category ID to get all products for a specified category. Replace {Your_Access_token} with your actual access token.
Use the request to get data for a base product, individual product, or product combinations. Replace the {productId or ERID} placeholder with the appropriate product identifier to retrieve detailed product information. Replace {your_API_key} with your actual access token. If multiple products are associated with the ERID, the response will include all of them.
Duplicate ERIDs are not allowed. To prevent duplicate ERIDs, when configuring company settings in Global Commerce. This ensures that you won't accidentally provide an ERID that would result in duplicate products in the response if you searched for a product by ERID.
To get a retired product version, specify the version=RETIRED query parameter in the request URL. Replace the {productId or ERID} placeholder with the appropriate product identifier to retrieve detailed product information. Replace {your_API_key} with your actual access token. For ERID requests, include the x-erid-as-pid=true header.
Include the version=DEPLOYED query parameter in the request URL to get a deployed product version. Replace {productId or ERID} with the appropriate product identifier and {your_API_key} with your actual access token. For ERID requests, include the x-erid-as-pid=true header.