Find purchases
Find purchases made through you.
Filter by one of these:
email: everything one buyer has bought.fromandto: everything bought between two dates.quoteId: one sale. TheidfromPOST /quotes, known before the buyer pays.paymentIntentId: one sale, by its Stripe payment (pi_…), for examplesale.purchaseIdfrom 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; withtestMode=true, only test ones. Each purchase says which it is intestMode. - If nothing matches, you get an empty list, not an error.
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
Query Parameters
The buyer's email.
emailFirst purchase date, inclusive, as YYYY-MM-DD. Send with to.
dateLast purchase date, inclusive, as YYYY-MM-DD. Send with from.
dateThe id from POST /quotes (cs_…).
^cs_The Stripe payment id (pi_…) of a sale.
^pi_true lists test-mode purchases instead of live ones.
falseResults 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/purchases"{ "data": [ { "id": 48213, "testMode": false, "buyer": { "email": "dispatch@acme-freight.com", "firstName": "Dana", "lastName": "Reyes" }, "product": { "name": "Physical Damage - Temporary Substitute", "insurer": "Incline P&C Group", "claimsPhone": "8005550123" }, "units": 3, "amountPaidCents": 4458, "perUnit": { "premiumCents": 1200, "taxesCents": 86, "feesCents": 200 }, "currency": "usd", "coverageStart": "2026-12-01T06:00:00.000Z", "coverageEnd": "2026-12-04T05:59:59.999Z", "certificatesZipUrl": "https://certificates-of-insurance.s3.amazonaws.com/48213/certificates.zip", "certificates": [ { "ordinal": 1, "coverageStart": "2026-12-01T06:00:00.000Z", "coverageEnd": "2026-12-02T05:59:59.999Z", "url": "https://certificates-of-insurance.s3.amazonaws.com/48213/certificate-91022.pdf" } ] } ], "page": 0, "limit": 25, "total": 1, "hasMore": false}