Companies API
GET /api/v1/companies
Returns the workspace's companies, sorted by createdAt descending (newest first), each with its owner when one is assigned. Requires the read:companies scope (or * for full access).
Request
GET /api/v1/companies HTTP/1.1
Host: agentlyleads.com
Authorization: Bearer alk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxQuery parameters
| Parameter | Description |
|---|---|
domain | Return only the company with this exact domain |
externalId | Return only the company with this external ID |
ownerId | Return only the companies owned by this workspace user |
updatedSince | ISO 8601 datetime — only companies updated at or after this moment (useful for incremental sync) |
limit | Page size, 1–1000 (default 100) |
cursor | The nextCursor value from the previous page |
All parameters are optional and can be combined. Filters that match nothing return an empty list, not a 404.
Look up a company by domain:
GET /api/v1/companies?domain=acme.com HTTP/1.1
Authorization: Bearer alk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxList one rep's accounts:
GET /api/v1/companies?ownerId=cmq9user0alk34567890 HTTP/1.1
Authorization: Bearer alk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxAn ownerId that owns no companies returns an empty list, not a 404. The id is the workspace user's id, which you can read off any record's owner.id.
Response — 200
{
"companies": [
{
"id": "cmq2comp0alk34567890",
"name": "Acme Corp",
"domain": "acme.com",
"industry": "Manufacturing",
"size": "51-200",
"website": "https://acme.com",
"notes": null,
"owner": {
"id": "cmq9user0alk34567890",
"name": "Kevin Rep"
},
"externalId": "hs_company_42",
"customFields": null,
"createdAt": "2026-06-01T12:00:00.000Z",
"updatedAt": "2026-07-20T14:03:00.000Z"
}
],
"nextCursor": null
}Pagination
Responses are cursor-paginated. When more rows exist beyond the requested limit, nextCursor holds the ID of the last returned record — pass it back as cursor to fetch the next page. On the last page, nextCursor is null.