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

API

Sell insurance from your own backend.

Sign up buyers, quote them, send them to pay, and fetch the certificates of insurance issued after they do.

The CoverPort API is a JSON REST API. You call it from your server with a secret key. If you only want a "Get insurance" button on your web pages, you do not need it: the SDK does that with one line and no server code.

Rolling out

This API is being enabled partner by partner. Until it is enabled for your key, every request returns 403 with error.code: "api_not_available". Email api-support@coverport.io to be enabled.

The basics

Base URLhttps://api.coverport.io/api
AuthenticationYour secret key in the x-api-key header. See Authentication.
VersionCoverPort-Version: 2026-11-20 on every request. See Versioning.
FormatJSON in and out. Money is in cents, in fields whose names end in Cents. Dates are YYYY-MM-DD.
Errors{ "error": { "code", "message", "details" }, "requestId" }, including requests the gateway refuses. See Errors.
RetriesSend Idempotency-Key on POST requests so a retry never does the work twice. See Retrying safely.

Your key is linked to one insurance agent: the one you sell for. You never send an agent id. Every buyer you sign up is connected to that agent, you only see products that agent offers, and every sale is attributed to you.

What you can do

ResourceEndpointsWhat it is
BuyersGET /buyers, POST /buyersThe trucking company or driver being insured. Find one, or sign one up.
ProductsGET /buyers/{id}/products, GET /buyers/{id}/products/{productId}What a buyer can purchase from you, and the questions each product asks.
QuotesPOST /quotesA priced purchase waiting for payment, with a link to pay.
PurchasesGET /purchases, GET /purchases/{id}/certificatesPaid purchases and their certificate of insurance PDFs.

A first request

curl "https://api.coverport.io/api/buyers?email=dispatch@acme-freight.com" \
  -H "x-api-key: $COVERPORT_API_KEY" \
  -H "CoverPort-Version: 2026-11-20"
{
  "data": [{ "id": "9f1c4e2a-3b7d-4c1e-8f2a-5d6b7c8e9f01", "email": "dispatch@acme-freight.com", "firstName": "Dana", "lastName": "Reyes" }],
  "page": 0,
  "limit": 1,
  "total": 1,
  "hasMore": false
}

Looking a buyer up changes nothing and sends no email. An empty data list means you have not signed this person up yet.

Where to go next

Test mode

Products are either test or live. Test products use Stripe test mode, so a quote never charges a real card; pay with Stripe's test card 4242 4242 4242 4242. GET /purchases lists live purchases only, unless you add testMode=true, which lists test purchases only. See Test purchases.

On this page