HTTP status codes

The status codes and error bodies the quote, category and order endpoints return, and what to do about each.

SureBright's quote and category endpoints return the result as the HTTP status code. Where a body carries an errorType, it has the same value as the status code.

Warranty quotes by product or URL#

GET /quote/api/quote/listWarrantyQuotes

200string

Quotes Found

501string

Insufficient Parameters – storeId, country, and either productUrl or both productId and variantId are required

502string

Validation Failed for Input Parameters – country must be a two-letter code and one of US or CA

503string

Invalid URL – the product or variant could not be resolved from productUrl (By Url only)

504string

Product Not Found, or product not eligible for a warranty

505string

Price band not found for the product's category and price

500string

Something Unexpectedly Went Wrong

Quotes by category#

GET /quote/api/quote/category/listQuotes

200string

Request processed. When no plan matches, the body still carries 200 with an empty quoteList and isError: true plus a statusMessage.

400string

Insufficient params – country, visitId, platform, a non-empty storeCategoryList, and storeId or storeParentId are required inside payload

500string

Internal Server Error

Store categories#

GET /quote/api/storeCategory/listStoreCategories

200string

Categories listed (an empty list when none are configured)

400string

Neither storeId nor storeParentId sent, invalid category or view, or (Ln tree stores) unknown category for this store

503string

Ln category tree unavailable (Ln tree stores only)

Whole system warranty#

The whole system endpoints use their own code set (512–520 on contract creation, 400/404/409/502 on quotes). They are listed on the List Quotes for Whole System Warranty and Create / Update Contracts for Whole System Warranty pages.

Order endpoints#

/partner/api/v1/order returns standard HTTP codes: 200, 207 (partial success, see errorList), 400, 401, 404 (lookup only) and 500. See the individual Order pages.