CargoLabs DocsCertificates of insurance
Fetch, search, and email the certificates issued after a sale.
After a successful payment, CoverPort issues one certificate of insurance (COI) PDF per covered unit and stores them. These endpoints let you retrieve and distribute them.
All endpoints are POST with a JSON body under:
https://api.coverport.io/coverport-agency-certsRoot-account variants of the same operations live under /coverport-agency-root-certs and take the root account's id in place of the teammate's.
Get certificates for a purchase
POST /coverport-agency-certs/getCertificatesPass the Stripe payment_intent id you received when the checkout session was created. The response lists every certificate generated for that payment with a download URL for each PDF, a per-payment zip, and a per-product zip that carries a QR link for proof of coverage.
Get invoice data
POST /coverport-agency-certs/getInvoiceDataReturns the Stripe invoice and line items behind a purchase, so you can show the buyer what they paid for alongside the certificates.
Search purchases
POST /coverport-agency-certs/searchTeammatePurchasedProductsFree-text search over purchases made through your agent: buyer name, email, product name, or certificate number. Use it to build a "my policies" view.
Email proof of coverage
POST /coverport-agency-certs/teamEmailProofofCoverageSends the certificate bundle to one or more email addresses from a CoverPort address. Useful when a shipper or broker asks a driver for proof of coverage.
Timing
Certificates are generated asynchronously when the Stripe webhook fires, usually within a few seconds of payment. If getCertificates returns nothing for a payment intent you know succeeded, wait and retry with backoff for up to two minutes before treating it as an error.
Request bodies
These endpoints share the body conventions of the quote flow: snake_case fields, the caller's account id, and where the buyer is involved, the buyer's cognito_accnt_uuid. Exact field lists are available from developer support while the reference for this surface is being completed.