By Category

This endpoint retrieves a list of warranty quotes for a specific store and category. The response includes detailed warranty options, pricing, and coverage information.

GET /quote/api/v1/category/listWarrantyQuotes?storeId={storeId}&country={country}&sbCategoryId={sbCategoryId}&price={price}

Try it

List Quotes by Category

cURL

curl --request GET \
  --url 'https://{HOST_NAME}/quote/api/v1/category/listWarrantyQuotes?storeId={storeId}&country={country}&sbCategoryId={sbCategoryId}&price={price}'

200

{
  "warrantyQuoteId": "929d14dd-2937-4290-9818-8fca2a00a9a3",
  "warrantyQuoteItemList": [
    {
      "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"
}

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

storeId · string · required

A unique identifier for a store will be shared as part of the integration kit. this will be added as path variable

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"

sbCategoryId · string · required

The URL containing the product page that is shown to the customer

Example:

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

price · number<float> · required

The price of the product in the currency of the country specified in the above parameter

Example:

230.54

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"

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"