CoverPort API and SDK are in beta. Endpoints and the embed may change without notice, and sales should be reconciled in the developer portal. Report problems to support@coverport.io.
CargoLabs Docs
Purchases

Find purchases

GET
/api/purchases

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.

Authorization

SecretKey
x-api-key<token>

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

email?string

The buyer's email.

Formatemail
from?string

First purchase date, inclusive, as YYYY-MM-DD. Send with to.

Formatdate
to?string

Last purchase date, inclusive, as YYYY-MM-DD. Send with from.

Formatdate
quoteId?string

The id from POST /quotes (cs_…).

Match^cs_
paymentIntentId?string

The Stripe payment id (pi_…) of a sale.

Match^pi_
testMode?boolean

true lists test-mode purchases instead of live ones.

Defaultfalse
limit?integer

Results per page, 1 to 100.

Range1 <= value <= 100
Default25
page?integer

Page number, starting at 0.

Range0 <= value
Default0

Header Parameters

CoverPort-Version?"2026-11-20"

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.

Default"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}