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#

HeaderDescriptionRequired
Content-Typeapplication/jsonYes

No authentication header is needed for this endpoint.

Query parameters#

stringrequired

Your store identifier. shop is accepted as an alias.

stringrequired

Two-letter country code of the customer, US or CA.

stringrequired

The visit identifier for this session.

string

Quote platform. Defaults to REGISTRATION_POST_PURCHASE; leave it out.

string

The platform your catalog lives on. Default SHOPIFY.

string

Restrict to one coverage type when the category offers more than one.

string

fr returns French coverage text where it exists.

string

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:

stringrequired

Product name. When productId is missing, SureBright matches the product by title; when no product matches, no quote is returned.

string

Product id in your catalog. When sent, the first variant of the product is quoted.

string

Variant id, when known.

string

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#

bash
curl -X POST 'https://{HOST_NAME}/quote/api/quote/listRegistrationQuotes?storeId=example-store.myshopify.com&country=US&visitId=6a0d0c1e-2b4f-4d8e-9f21-3c5e7a9b1d2f&quoteSyncMode=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:

storeProductIdstring

The product SureBright matched.

storeVariantIdstring

The variant SureBright quoted.

PolicyDataobject[]

One entry per plan, with quoteItemId, price, monthlyPrice, coverageYears, deductibleAmount and defaultSelection.

statusMessagestring

POLICY_FETCHED_SUCCESSFULLY, or the reason no plan was found.

Errors#

Business outcomes are returned with HTTP 200, so read isError and statusMessage.

CodeBodyMeaning
200{"isError": true, "message": "Registration post purchase quotes are not available for more than 30 days"}dateOfPurchase is outside the post-purchase window (the number of days is the store's window)
200statusMessage such as PRODUCT_DETAILS_NOT_FOUND, empty PolicyDataNo product matched the title or id, or the product is not covered
400{"isError": true, "message": "Insufficient params"}storeId, country or visitId missing
500{"isError": true, "message": "Internal Server Error"}Unexpected failure

Responses are not cached.