---
title: "Product quotes in bulk"
description: "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

| Header | Description | Required |
|--------|-------------|----------|
| Content-Type | application/json | Yes |

No authentication header is needed for this endpoint.

## Query parameters

<ParamField query="platform" type="string" required>
  `SHOPIFY`. Any other value returns an empty list.
</ParamField>
<ParamField query="storeId" type="string" required>
  Your `myshopify.com` store identifier.
</ParamField>

## Body

<ParamField body="productList" type="object[]" required>
  <Expandable title="fields">
    <ParamField body="productId" type="string" required>
      Shopify product id. Entries without it are skipped.
    </ParamField>
    <ParamField body="variantId" type="string">
      Shopify variant id. Leave it out to quote every variant of the product.
    </ParamField>
  </Expandable>
</ParamField>

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

<ResponseField name="storeProductId" type="string">
  The product quoted.
</ResponseField>
<ResponseField name="storeVariantId" type="string">
  The variant quoted.
</ResponseField>
<ResponseField name="country" type="string">
  The country the quote was priced in: the store's country, or the point-of-sale country SureBright has set for the store.
</ResponseField>
<ResponseField name="PolicyData" type="object[]">
  One entry per plan, with `quoteId`, `quoteItemId`, `price`, `monthlyPrice`, `coverageYears`, `deductibleAmount` and the plan `productId` and `variantId` to add to the sale.
</ResponseField>
<ResponseField name="statusMessage" type="string">
  `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.
</ResponseField>

```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

| Code | Body | Meaning |
|------|------|---------|
| `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.
