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

Get a purchase's certificates

GET
/api/purchases/{purchaseId}/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
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

Path Parameters

purchaseId*integer

A purchase id from GET /purchases.

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/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.