Product quotes in bulk
Quote several Shopify products in one call, for point-of-sale and other screens that list many products.
POST https://{HOST_NAME}/quote/api/quote/listProductQuotes
Use this endpoint when one screen shows many products and you need a plan price for each, for example a Shopify POS tile or a recommendation panel. You send product ids; SureBright quotes every listed variant (or every variant of a product when you leave variantId out) in the store's own country and returns one quote object per variant.
Shopify stores only. For a single product with the shopper's country, use By Product.
Headers#
No authentication header is needed for this endpoint.
Query parameters#
SHOPIFY. Any other value returns an empty list.
Your myshopify.com store identifier.
Body#
Example request#
curl -X POST 'https://{HOST_NAME}/quote/api/quote/listProductQuotes?platform=SHOPIFY&storeId=example-store.myshopify.com' \
-H 'Content-Type: application/json' \
-d '{
"productList": [
{ "productId": "8011223344556", "variantId": "44011223344556" },
{ "productId": "8011223344999" }
]
}'Response#
A JSON array with one standard quote object (see By Product) per variant, in request order, plus:
storeProductIdstringThe product quoted.
storeVariantIdstringThe variant quoted.
countrystringThe country the quote was priced in: the store's country, or the point-of-sale country SureBright has set for the store.
PolicyDataobject[]One entry per plan, with quoteId, quoteItemId, price, monthlyPrice, coverageYears, deductibleAmount and the plan productId and variantId to add to the sale.
statusMessagestringPOLICY_FETCHED_SUCCESSFULLY, or why a variant got no plan (for example POLICY_BAND_NOT_FOUND). A variant that fails outright is left out of the array.
[
{
"quoteId": "4d2a9e7c-1b3f-4a6d-9c8e-2f1a3b4c5d6e",
"productTitle": "Aero 2 Electric Scooter",
"ProductPrice": 899,
"statusMessage": "POLICY_FETCHED_SUCCESSFULLY",
"PolicyData": [
{ "quoteItemId": "a1b2c3d4-0001", "price": 89.99, "monthlyPrice": 3.75, "coverageYears": 2, "deductibleAmount": 0, "defaultSelection": true }
],
"storeProductId": "8011223344556",
"storeVariantId": "44011223344556",
"country": "US"
}
]Errors#
Responses are not cached. Each request and response is logged by SureBright for support.