System warranty quotes by account
Price a whole-system plan from a list of priced line items or a total, without saving a proposal.
POST https://{HOST_NAME}/quote/api/quote/systemwarranty/listQuotes
This endpoint prices a whole-system plan for an installed system from the line items (or just the total) and the installer's own warranty term. Unlike For Whole System Warranty, it is keyed on your SureBright account rather than a store, and it does not save a proposal or return proposal ids, so its quotes cannot be turned into a contract.
New integrations should use For Whole System Warranty (POST /quote/api/whole-system/listQuotes), which saves the quote as a proposal you can update and convert into a contract. This endpoint backs the pricing shown in the installer portal, where installers quote and record Whole System Warranty sales. It is not used by the Merchant Portal. For the API flow, read the Whole System Warranty guide.
Headers#
No authentication header is needed for this endpoint.
Query parameters#
SYNC to save the quote before responding. Default ASYNC.
Body#
The system's components. Required unless totalPrice is sent. Only items with an sbCategoryId, a unit price above zero and a quantity above zero count towards the total. SureBright also leaves out an item whose unit price is above the limit it sets; ask your SureBright contact if an item you expected is not counted.
Total system price, used when lineItemsList is not sent.
The installer's own warranty on the system, in months. Priced terms are 3, 6 and 12. Other values round down to the nearest priced term; values below 3 return 513.
Example request#
curl -X POST 'https://{HOST_NAME}/quote/api/quote/systemwarranty/listQuotes' \
-H 'Content-Type: application/json' \
-d '{
"storeInfo": { "storeParentId": "0f6c1d2e-7a8b-4c9d-8e1f-2a3b4c5d6e7f", "currency": "USD" },
"lineItemsList": [
{ "sbCategoryId": "2b7e4f10-9c3a-4d5e-8f61-7a2b3c4d5e6f", "productPrice": 4200, "quantity": 1 },
{ "sbCategoryId": "2b7e4f10-9c3a-4d5e-8f61-7a2b3c4d5e6f", "productPrice": 650, "quantity": 2 }
],
"installerWarrantyDuration": 12
}'Response#
quoteListobject[]One standard quote object (see By Category) priced on the system total. PolicyData carries one entry per plan term with quoteId, quoteItemId, price, coverageYears and deductibleAmount.
sbCategoryIdstringThe system-warranty category the quote was priced against.