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#

HeaderDescriptionRequired
Content-Typeapplication/jsonYes

No authentication header is needed for this endpoint.

Query parameters#

stringrequired

SHOPIFY. Any other value returns an empty list.

stringrequired

Your myshopify.com store identifier.

Body#

object[]required

Example request#

bash
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:

storeProductIdstring

The product quoted.

storeVariantIdstring

The variant quoted.

countrystring

The 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.

statusMessagestring

POLICY_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.

json
[
  {
    "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#

CodeBodyMeaning
200[]The store was not found or has no country set
400[]Body, platform or storeId missing, or platform is not SHOPIFY
500[]Unexpected failure

Responses are not cached. Each request and response is logged by SureBright for support.