By Product Details

This endpoint retrieves a list of warranty quotes based on product details (title, description, and price). The response includes detailed warranty options, pricing, and coverage information similar to other quote endpoints.

POST /api/v1/quote/listWarrantyQuotes?storeId={storeId}&country={country}

Try it

List Quotes by Product Details

cURL

curl --request POST \
  --url 'https://{HOST_NAME}/api/v1/quote/listWarrantyQuotes?storeId={storeId}&country={country}' \
  --header 'Content-Type: application/json' \
  --data '
{
  "productTitle": "Sony Bravia OLED 4K",
  "productPrice": 21,
  "productDescription": "4K LED TV"
}
'

200

{
  "warrantyQuoteId": "929d14dd-2937-4290-9818-8fca2a00a9a3",
  "warrantyQuoteItemList": [
    {
      "warrantyTenure": 2,
      "warrantyPrice": 64.99,
      "warrantyQuoteItemId": "8c78bc1a-0790-4cd3-a3f9-5ed97bbe59f5",
      "warrantySKU": "SBW-1U-SHAB-40099"
    }
  ],
  "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)."
      ]
    }
  ],
  "lowerPrice": 0,
  "upperPrice": 499.99,
  "tncLink": "https://customer.surebright.com/t-c/098e0e696f20839479dfe4a2804756233d32130f068441e24c6c0dbbc790677ff9718e04396a18dac753d0cf92bcaf63a26d2b666e5326475d0b2ed7475ad7fc",
  "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
Content-Type	application/json	Yes

Country and State Codes

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

Query Parameters

storeId · string · required

A unique identifier for a store will be shared as part of the integration kit

Example:

"ecca4210-09a4-446c-ad87-5e65bd50df12"

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"

Body

application/json

productTitle · string · required

The title or name of the product

Example:

"Sony Bravia OLED 4K"

productPrice · number · required

The price of the product

Example:

21

productDescription · string

The description of the product

Example:

"4K LED TV"

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

warrantyQuoteItemList. warrantySKU · string

Unique SKU for the warranty quote item

Example:

"SBW-1U-SHAB-40099"

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)."
]

lowerPrice · number<float>

Example:

0

upperPrice · number<float>

Example:

499.99

tncLink · string

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

Example:

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

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"