By Product

This endpoint retrieves a list of warranty quotes for a specific product and its price.

GET /quote/api/quote/listWarrantyQuotes?platform={platform}&storeId={storeId}&productId={productId}&variantId={variantId}&country={country}

Try it

List Warranty Quotes by Product

cURL

curl --request GET \
  --url 'https://{HOST_NAME}/quote/api/quote/listWarrantyQuotes?platform={platform}&storeId={storeId}&productId={productId}&variantId={variantId}&country={country}'

200

{
  "warrantyQuoteId": "929d14dd-2937-4290-9818-8fca2a00a9a3",
  "warrantyQuoteItemList": [
    {
      "warrantyProductId": 7080029454439,
      "warrantyVariantId": 40937702359143,
      "warrantyTenure": 2,
      "warrantyPrice": 64.99,
      "warrantyQuoteItemId": "8c78bc1a-0790-4cd3-a3f9-5ed97bbe59f5"
    }
  ],
  "coverageWidgetHeading": "Add premium product protection",
  "coveragePopupHeading": "Don't want to spend extra on this product for the next few years? We've got you covered!",
  "coverageList": [
    {
      "coverageItemType": "COVERAGE_OPTION",
      "coverageItemTitle": "Your warranty plan provides,",
      "coverageItemList": [
        "Protection against everyday spills (food, beverages, human or pet biological stains, cosmetics, etc)."
      ]
    }
  ],
  "tncLink": "https://customer.surebright.com/t-c/098e0e696f20839479dfe4a2804756233d32130f068441e24c6c0dbbc790677ff9718e04396a18dac753d0cf92bcaf63a26d2b666e5326475d0b2ed7475ad7fc",
  "sbCategoryId": "4c3103e4-38dc-4171-96e5-b4b77ab0e96f",
  "productImageUrl": "https://cdn.shopify.com/s/files/1/0254/6227/6182/products/bedbathandimage.jpg?v=1664467971"
}

Headers

Header	Description	Required
X-SureBright-Access-Token	Access token for authentication	No

Country and State Codes

• Country codes (Alpha 2): IBAN Country Codes
• US State codes: FIPS State Codes

Query Parameters

platform · string · required

The platform of the merchant's store.

Example:

"SHOPIFY"

storeId · string · required

The unique identifier for the merchant's store. This is typically the store's domain name (e.g., 'yourstore.myshopify.com' for Shopify stores).

Example:

"strictlyapple.myshopify.com"

productId · string · required

The ID of the product that is shown to the customer

Example:

"8606368530686"

variantId · string · required

The ID of the variant that is shown to the customer

Example:

"45667967238398"

country · string · required

The country code of the identified customer location

Example:

"US"

state · string

The state code of the identified customer location

Example:

"AL"

Response

200

application/json

Quotes Found

warrantyQuoteId · string · required

A unique ID representing this specific return quote in this particular API call

Example:

"929d14dd-2937-4290-9818-8fca2a00a9a3"

warrantyQuoteItemList · object[] · required

A list of warranty offers generated for this particular request

Show child attributes

warrantyQuoteItemList. warrantyProductId · integer

Product ID of the warranty item

Example:

7080029454439

warrantyQuoteItemList. warrantyVariantId · integer

Variant ID of the warranty item

Example:

40937702359143

warrantyQuoteItemList. warrantyTenure · integer

Duration of the warranty in years

Example:

2

warrantyQuoteItemList. warrantyPrice · number<float>

Price of the warranty

Example:

64.99

warrantyQuoteItemList. warrantyQuoteItemId · string

Unique identifier for the warranty quote item

Example:

"8c78bc1a-0790-4cd3-a3f9-5ed97bbe59f5"

coverageWidgetHeading · string · required

Heading for the various tenure options shown to a customer on the product page

Example:

"Add premium product protection"

coveragePopupHeading · string · required

Title that nudges the customers to buy a warranty for their product purchase

Example:

"Don't want to spend extra on this product for the next few years? We've got you covered!"

coverageList · object[] · required

List of coverage options grouped under different sections

Show child attributes

coverageList. coverageItemType · enum<string>

Available options: COVERAGE_OPTION, WHY_SUREBRIGHT

Example:

"COVERAGE_OPTION"

coverageList. coverageItemTitle · string

Example:

"Your warranty plan provides,"

coverageList. coverageItemList · string[]

Example:

[
  "Protection against everyday spills (food, beverages, human or pet biological stains, cosmetics, etc)."
]

tncLink · string

Unique link for legal Terms & Conditions of the warranty for each product Category

Example:

"https://customer.surebright.com/t-c/098e0e696f20839479dfe4a2804756233d32130f068441e24c6c0dbbc790677ff9718e04396a18dac753d0cf92bcaf63a26d2b666e5326475d0b2ed7475ad7fc"

sbCategoryId · string

SureBright Category ID of the warranty item

Example:

"4c3103e4-38dc-4171-96e5-b4b77ab0e96f"

productImageUrl · string

Link of the product image that can be show as part of the warranty offer UI

Example:

"https://cdn.shopify.com/s/files/1/0254/6227/6182/products/bedbathandimage.jpg?v=1664467971"