Get a purchase's certificates
Get the certificate of insurance PDFs for a purchase.
There's one certificate for each day or trip covered, in order. If a certificate was corrected after purchase, its url points to the corrected PDF.
Certificates are issued a few seconds after payment. If a purchase that was just paid has none yet, try again for up to two minutes.
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 purchase id from GET /purchases.
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
curl -X GET "https://example.com/api/purchases/48213/certificates"{ "data": [ { "id": 91022, "ordinal": 1, "url": "https://certificates-of-insurance.s3.amazonaws.com/48213/certificate-91022.pdf", "issuedAt": "2026-12-01T15:21:09.000Z", "reissued": false } ], "page": 0, "limit": 1, "total": 1, "hasMore": false}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.
Find purchases GET
Find purchases made through you. Filter by **one** of these: - `email`: everything one buyer has bought. - `from` and `to`: everything bought between two dates. - `quoteId`: one sale. The `id` from `POST /quotes`, known before the buyer pays. - `paymentIntentId`: one sale, by its Stripe payment (`pi_…`), for example `sale.purchaseId` from the JavaScript SDK. **Good to know** - Newest purchases come first. - A purchase appears a few seconds after the buyer pays, once its certificates are issued. - Live and test purchases are never mixed. Without `testMode`, only live purchases are listed; with `testMode=true`, only test ones. Each purchase says which it is in `testMode`. - If nothing matches, you get an empty list, not an error.