---
title: "Registration quotes"
description: "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](/api-reference/endpoint/quote/order-quotes).

## Headers

| Header | Description | Required |
|--------|-------------|----------|
| Content-Type | application/json | Yes |

No authentication header is needed for this endpoint.

## Query parameters

<ParamField query="storeId" type="string" required>
  Your store identifier. `shop` is accepted as an alias.
</ParamField>
<ParamField query="country" type="string" required>
  Two-letter country code of the customer, `US` or `CA`.
</ParamField>
<ParamField query="visitId" type="string" required>
  The visit identifier for this session.
</ParamField>
<ParamField query="platform" type="string">
  Quote platform. Defaults to `REGISTRATION_POST_PURCHASE`; leave it out.
</ParamField>
<ParamField query="storePlatform" type="string">
  The platform your catalog lives on. Default `SHOPIFY`.
</ParamField>
<ParamField query="coverageType" type="string">
  Restrict to one coverage type when the category offers more than one.
</ParamField>
<ParamField query="locale" type="string">
  `fr` returns French coverage text where it exists.
</ParamField>
<ParamField query="quoteSyncMode" type="string">
  `SYNC` to save the quote before responding. Send it when you will record an order with the returned ids.
</ParamField>

## Body

The body is the registration as the customer entered it. SureBright stores it with the quote and reads these fields:

<ParamField body="productTitle" type="string" required>
  Product name. When `productId` is missing, SureBright matches the product by title; when no product matches, no quote is returned.
</ParamField>
<ParamField body="productId" type="string">
  Product id in your catalog. When sent, the first variant of the product is quoted.
</ParamField>
<ParamField body="variantId" type="string">
  Variant id, when known.
</ParamField>
<ParamField body="dateOfPurchase" type="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).
</ParamField>

## 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:

<ResponseField name="storeProductId" type="string">
  The product SureBright matched.
</ResponseField>
<ResponseField name="storeVariantId" type="string">
  The variant SureBright quoted.
</ResponseField>
<ResponseField name="PolicyData" type="object[]">
  One entry per plan, with `quoteItemId`, `price`, `monthlyPrice`, `coverageYears`, `deductibleAmount` and `defaultSelection`.
</ResponseField>
<ResponseField name="statusMessage" type="string">
  `POLICY_FETCHED_SUCCESSFULLY`, or the reason no plan was found.
</ResponseField>

## Errors

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

| Code | Body | Meaning |
|------|------|---------|
| `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) |
| `200` | `statusMessage` such as `PRODUCT_DETAILS_NOT_FOUND`, empty `PolicyData` | No 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.
