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 URL | https://api.coverport.io/api |
| Authentication | Your secret key in the x-api-key header. See Authentication. |
| Version | CoverPort-Version: 2026-11-20 on every request. See Versioning. |
| Format | JSON 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. |
| Retries | Send 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
| Resource | Endpoints | What it is |
|---|---|---|
| Buyers | GET /buyers, POST /buyers | The trucking company or driver being insured. Find one, or sign one up. |
| Products | GET /buyers/{id}/products, GET /buyers/{id}/products/{productId} | What a buyer can purchase from you, and the questions each product asks. |
| Quotes | POST /quotes | A priced purchase waiting for payment, with a link to pay. |
| Purchases | GET /purchases, GET /purchases/{id}/certificates | Paid 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
Authentication
Get a key and send it.
Sign up buyers
Create or connect buyers from your own form.
Quote to checkout
Read a product, answer its questions, get a payment link.
Purchases and certificates
Confirm a sale and fetch its certificates.
Errors
Error codes and what to retry.
Versioning
How the API changes without breaking you.
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.