Find a buyer by email
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 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
The buyer's email address. Case does not matter.
emailHeader Parameters
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.
"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}Purchases and certificates
Confirm a sale, find a buyer's policies, and fetch the certificate of insurance PDFs.
Sign up a buyer POST
Sign up a buyer so you can quote them. The buyer is connected to you and emailed a way to sign in. What you send, and what happens, depends on the email address: - **New to CoverPort:** send `email`, `firstName` and `lastName`. We create their account and email them a temporary password. Response: `201`. - **Already has a CoverPort account:** send `email`. We connect them to you and email them that they can now buy from you. Response: `200`. - **New, but you didn't send a name:** nothing is created. Response: `422` with `error.code` `name_required`. Ask for their name and try again. **Good to know** - This sends email, so call it once per sign-up. To look a buyer up, use `GET /buyers`. Send an `Idempotency-Key` so a retry cannot email twice. - Each key can sign up 30 buyers an hour and 100 a day. Over that, you get `429` with `error.code` `signup_limit` and a `Retry-After` header.