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
Buyers

Find a buyer by email

GET
/api/buyers

Look up a buyer you've already signed up, by their email.

Safe to call at any time: it never changes anything or sends email.

What you get back

  • The buyer, if you've signed them up.
  • An empty list if you haven't. The person may still have a CoverPort account through someone else. To sign them up with you, use POST /buyers.

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 address. Case does not matter.

Formatemail

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

curl -X GET "https://example.com/api/buyers?email=dispatch%40acme-freight.com"
{  "data": [    {      "id": "9f1c4e2a-3b7d-4c1e-8f2a-5d6b7c8e9f01",      "email": "dispatch@acme-freight.com",      "firstName": "Dana",      "lastName": "Reyes"    }  ],  "page": 0,  "limit": 1,  "total": 1,  "hasMore": false}