List companies
Your companies, newest first, with how many people each has.
GET
/api/v1/leadsScope
leads:readReturns a page of companies, newest first. Each one carries contactCount.
Query parameters
Prop
Type
Example request
curl "https://api.pedibee.com/api/v1/leads?search=north&tier=HOT&limit=20" \
-H "Authorization: Bearer $PEDIBEE_API_KEY"Response
{
"data": [
{
"id": "66f1c2a9e4b0a1b2c3d4e001",
"companyName": "Northwind",
"domain": "northwind.io",
"industry": "Software",
"tier": "HOT",
"lifecycleStage": "NEW",
"notes": null,
"source": "MANUAL",
"createdAt": "2026-10-05T09:30:00.000Z",
"updatedAt": "2026-10-05T09:30:00.000Z",
"contactCount": 3
}
],
"total": 1,
"skip": 0,
"limit": 20
}Errors
Every error is { "error": "…" } with a message you can show. See Errors and limits.
| Status | When |
|---|---|
403 | The key doesn’t have leads:read, or its creator’s role no longer allows it. |
401 | The API key is missing, invalid, revoked or expired. |
429 | Too many requests. Wait for the seconds in Retry-After. |