Get a product, with a quote template
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
- Take
quoteTemplatefrom the response. - Fill in each answer's
value. Answers markedrequired: truecan't be left blank. - Set
startDate, andunits: the number of days or trips to cover (the product'sunitsays which). - Send it to
POST /quotes.
You can leave the question and required fields in the template when you send it back; they're ignored.
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.
uuidA product id from GET /buyers/{buyerId}/products.
Header 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
application/json
curl -X GET "https://example.com/api/buyers/9f1c4e2a-3b7d-4c1e-8f2a-5d6b7c8e9f01/products/105"{ "id": 105, "name": "Physical Damage - Temporary Substitute", "description": "Daily Physical Damage", "unit": "day", "maxUnits": 127, "insurer": "Incline P&C Group", "questions": [ { "id": 286, "group": null, "label": "VIN #", "type": "text", "required": true }, { "id": 291, "group": "Named Insured", "label": "Insured's Name", "type": "text", "required": true } ], "quoteTemplate": { "buyerId": "9f1c4e2a-3b7d-4c1e-8f2a-5d6b7c8e9f01", "productId": 105, "startDate": "2026-12-01", "units": 1, "timeZone": "America/New_York", "answers": [ { "questionId": 286, "value": "", "question": "VIN #", "required": true }, { "questionId": 291, "value": "", "question": "Named Insured: Insured's Name", "required": true } ] }}Sign up a buyer POST
Sign up a buyer so you can quote them. The buyer is connected to you and emailed a way to sign in. What you send, and what happens, depends on the email address: - **New to CoverPort:** send `email`, `firstName` and `lastName`. We create their account and email them a temporary password. Response: `201`. - **Already has a CoverPort account:** send `email`. We connect them to you and email them that they can now buy from you. Response: `200`. - **New, but you didn't send a name:** nothing is created. Response: `422` with `error.code` `name_required`. Ask for their name and try again. **Good to know** - This sends email, so call it once per sign-up. To look a buyer up, use `GET /buyers`. Send an `Idempotency-Key` so a retry cannot email twice. - Each key can sign up 30 buyers an hour and 100 a day. Over that, you get `429` with `error.code` `signup_limit` and a `Retry-After` header.
List the products a buyer can purchase GET
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.