Get a company
One company, with the people who work there.
GET
/api/v1/leads/:idScope
leads:readReturns the company and its people. With a key that can read contacts (contacts:read or contacts:write), contacts holds each person in full. Without it, you get only their ids in contactIds, so a companies-only key never sees people's details.
Path parameters
Prop
Type
Example request
curl "https://api.pedibee.com/api/v1/leads/66f1c2a9e4b0a1b2c3d4e001" \
-H "Authorization: Bearer $PEDIBEE_API_KEY"Response
With a key that can read contacts:
{
"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",
"contacts": [
{
"id": "66f1c2a9e4b0a1b2c3d4e5f6",
"email": "jane@northwind.io",
"name": "Jane Cooper",
"title": "CTO",
"phone": "+1 555 0100",
"linkedIn": "https://www.linkedin.com/in/janecooper",
"notes": null,
"stage": "NEW",
"source": "MANUAL",
"verified": false,
"emailConfidence": 0,
"customFields": {
"plan": "Pro",
"seats": 25
},
"leadId": "66f1c2a9e4b0a1b2c3d4e001",
"listIds": [
"66f1c2a9e4b0a1b2c3d4e101"
],
"createdAt": "2026-10-05T09:30:00.000Z",
"updatedAt": "2026-10-05T09:30:00.000Z"
}
]
}Without contacts access:
{ "id": "66f1c2a9e4b0a1b2c3d4e001", "companyName": "Northwind", "...": "...", "contactIds": ["66f1c2a9e4b0a1b2c3d4e5f6"] }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. |
404 | No company with this id in your workspace. |
401 | The API key is missing, invalid, revoked or expired. |
429 | Too many requests. Wait for the seconds in Retry-After. |