Registration quotes
Quote a plan for a product a customer bought earlier and is now registering, matched by title or product id.
POST https://{HOST_NAME}/quote/api/quote/listRegistrationQuotes
Use this endpoint on a product registration page: the customer already owns the product and gives you its name (or you know its product id) and the purchase date. SureBright finds the product in your catalog, prices the plan on the purchase price when it can, and checks that the purchase is still inside the post-purchase window. The response is the standard quote object.
For plans offered on an existing order rather than a registration, see Order quotes.
Headers#
No authentication header is needed for this endpoint.
Query parameters#
Your store identifier. shop is accepted as an alias.
Two-letter country code of the customer, US or CA.
The visit identifier for this session.
Quote platform. Defaults to REGISTRATION_POST_PURCHASE; leave it out.
The platform your catalog lives on. Default SHOPIFY.
Restrict to one coverage type when the category offers more than one.
fr returns French coverage text where it exists.
SYNC to save the quote before responding. Send it when you will record an order with the returned ids.
Body#
The body is the registration as the customer entered it. SureBright stores it with the quote and reads these fields:
Product name. When productId is missing, SureBright matches the product by title; when no product matches, no quote is returned.
Product id in your catalog. When sent, the first variant of the product is quoted.
Variant id, when known.
Purchase date (ISO 8601). When sent, the registration is rejected if it is older than the store's post-purchase window (30 days unless SureBright has set a different window for your store).
Example request#
curl -X POST 'https://{HOST_NAME}/quote/api/quote/listRegistrationQuotes?storeId=example-store.myshopify.com&country=US&visitId=6a0d0c1e-2b4f-4d8e-9f21-3c5e7a9b1d2f"eSyncMode=SYNC' \
-H 'Content-Type: application/json' \
-d '{
"productTitle": "Aero 2 Electric Scooter",
"dateOfPurchase": "2026-10-28",
"email": "customer@example.com"
}'Response#
The standard quote object (see By Product), plus:
storeProductIdstringThe product SureBright matched.
storeVariantIdstringThe variant SureBright quoted.
PolicyDataobject[]One entry per plan, with quoteItemId, price, monthlyPrice, coverageYears, deductibleAmount and defaultSelection.
statusMessagestringPOLICY_FETCHED_SUCCESSFULLY, or the reason no plan was found.
Errors#
Business outcomes are returned with HTTP 200, so read isError and statusMessage.
Responses are not cached.