Companies
The companies in your workspace.
Ordered by id. q matches the name. domain is an exact match. Requires ReadAccess.
Parameters
Name
In
Type
Required
Description
Q
In: query
string
optional
Domain
In: query
string
optional
Cursor
In: query
string
optional
Limit
In: query
integer (int32)
optional
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise
400 workspace_required).Response 200
data is a list of CompanyModel. Each item has these fields. The response also carries pagination.
Field
Type
Description
id
integer (int64)
name
string
domain
string
linkedInUrl
string
industry
string
employeeCount
integer (int32)
location
string
createdAt
string (date-time)
updatedAt
string (date-time)
Request
curl -X GET "https://api.ken.so/v1/companies" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 2026-11-02" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
"success": true,
"data": [
{
"id": 812,
"name": "string",
"domain": "example.com",
"linkedInUrl": "https://example.com",
"industry": "string",
"employeeCount": 1,
"location": "string",
"createdAt": "2026-09-23T15:02:11Z",
"updatedAt": "2026-09-23T15:02:11Z"
}
],
"pagination": {
"nextCursor": "eyJpZCI6ODE1fQ",
"hasMore": true,
"total": 1,
"isTotalCapped": true
}
}Return one company in the current workspace
GET
/v1/companies/{companyId}companies.getA missing or cross-workspace id is not_found. Requires ReadAccess.
Parameters
Name
In
Type
Required
Description
companyId
In: path
integer (int64)
required
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise
400 workspace_required).Response 200
data is a CompanyModel.
Field
Type
Description
id
integer (int64)
name
string
domain
string
linkedInUrl
string
industry
string
employeeCount
integer (int32)
location
string
createdAt
string (date-time)
updatedAt
string (date-time)
Request
curl -X GET "https://api.ken.so/v1/companies/812" \ -H "Authorization: Bearer $KEN_API_KEY" \ -H "Ken-Version: 2026-11-02" \ -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
"success": true,
"data": {
"id": 812,
"name": "string",
"domain": "example.com",
"linkedInUrl": "https://example.com",
"industry": "string",
"employeeCount": 1,
"location": "string",
"createdAt": "2026-09-23T15:02:11Z",
"updatedAt": "2026-09-23T15:02:11Z"
}
}