List the products a buyer can purchase
List the insurance products a buyer can buy from you.
Each product lists the questions a quote must answer. When you're ready to quote one, get it with GET /buyers/{buyerId}/products/{productId}: that response includes a ready-to-fill quote request.
Authorization
SecretKey Your secret API key from the developer portal (API Keys). Keep it on your server: never put it in browser or mobile code.
In: header
Path Parameters
A buyer id from GET /buyers or POST /buyers.
uuidQuery Parameters
Results per page, 1 to 100.
1 <= value <= 10025Page number, starting at 0.
0 <= value0Header Parameters
The API version you built against, as a date. Send it on every request. Without it you get the oldest
version still supported. An unknown version is 400 unsupported_version.
"2026-11-20"Value in
- "2026-11-20"
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/buyers/9f1c4e2a-3b7d-4c1e-8f2a-5d6b7c8e9f01/products"{ "data": [ { "id": 105, "name": "Physical Damage - Temporary Substitute", "description": "Daily Physical Damage", "unit": "day", "maxUnits": 127, "insurer": "Incline P&C Group", "claimsPhone": "8005550123", "videoUrl": "https://www.youtube.com/embed/afDACQtY4R4", "agreements": [ { "name": "Terms & Conditions.pdf", "url": "https://certificates-of-insurance.s3.amazonaws.com/product-policy-docs/terms.pdf" } ], "questions": [ { "id": 286, "group": null, "label": "VIN #", "type": "text", "required": true }, { "id": 289, "group": null, "label": "Stated Value of Unit", "type": "number", "required": true, "placeholder": "Stated Value (USD)" }, { "id": 291, "group": "Named Insured", "label": "Insured's Name", "type": "text", "required": true, "placeholder": "ie) JB Hunt" }, { "id": 296, "group": "Certificate Holder #1", "label": "Entity Email", "type": "text", "required": false, "format": "email", "formatDescription": "An email address." } ] } ], "page": 0, "limit": 25, "total": 1, "hasMore": false}Get a product, with a quote template GET
Get one product, with a quote request ready for you to fill in. You get everything from the product list, plus `quoteTemplate`: a complete request body for `POST /quotes`. **To quote this product** 1. Take `quoteTemplate` from the response. 2. Fill in each answer's `value`. Answers marked `required: true` can't be left blank. 3. Set `startDate`, and `units`: the number of days or trips to cover (the product's `unit` says which). 4. Send it to `POST /quotes`. You can leave the `question` and `required` fields in the template when you send it back; they're ignored.
Quote a product and get a payment link POST
Price a product for a buyer and get a link where they can pay. **How it works** 1. Send the buyer's answers. The easiest way to build this request is to fill in the `quoteTemplate` from `GET /buyers/{buyerId}/products/{productId}`. 2. Send the buyer to the `paymentUrl` in the response. 3. When they've paid, the purchase is created and its certificates are issued, usually within seconds. Find it with `GET /purchases?quoteId=` and the quote's `id`. Nothing is bought until the buyer pays. Each call makes a new payment page: send an `Idempotency-Key` so a retry after a timeout gets the first quote back instead of a second one. **If something is wrong**, you get a `400`. `error.details` lists every problem, each naming the question it's about, so you can fix them all at once.