Skip to content

List all companies

GET
/api/nova/companies/list

Returns a paginated list of all companies in the account, sorted by creation date with the newest first. Accepts page (default 0) and size (default 20, capped at 100) parameters. This is equivalent to calling the search endpoint with an empty query. The response includes the company records plus page, size and total count metadata.

Authorizations

privateApiKey
Type
API Key (query: apiKey)

Parameters

Query Parameters

apiKey*

apiKey

Type
string
Required
page

page

Type
integer
Format
"int32"
Default
0
size

size

Type
integer
Format
"int32"
Default
20

Responses

OK

application/json
JSON
{
  
"data": [
  
  
{
  
  
  
"activeJobCount": 0,
  
  
  
"annualRevenue": 0,
  
  
  
"client": true,
  
  
  
"createdOn": "string",
  
  
  
"customFields": [
  
  
  
  
{
  
  
  
  
  
"boolValue": "string",
  
  
  
  
  
"dateValue": "string",
  
  
  
  
  
"fieldId": "string",
  
  
  
  
  
"fieldLabel": "string",
  
  
  
  
  
"listValue": [
  
  
  
  
  
  
"string"
  
  
  
  
  
],
  
  
  
  
  
"value": "string"
  
  
  
  
}
  
  
  
],
  
  
  
"description": "string",
  
  
  
"domain": "string",
  
  
  
"email": "string",
  
  
  
"employeeCount": 0,
  
  
  
"facebook": "string",
  
  
  
"faxNo": "string",
  
  
  
"foundedYear": 0,
  
  
  
"id": "string",
  
  
  
"industryId": "string",
  
  
  
"industryName": "string",
  
  
  
"lastActivityDate": "string",
  
  
  
"linkedIn": "string",
  
  
  
"location": "string",
  
  
  
"name": "string",
  
  
  
"ownerId": "string",
  
  
  
"ownerName": "string",
  
  
  
"parentCompanyId": "string",
  
  
  
"parentCompanyName": "string",
  
  
  
"phone": "string",
  
  
  
"rating": 0,
  
  
  
"reference": "string",
  
  
  
"sectorId": "string",
  
  
  
"sectorName": "string",
  
  
  
"size": "string",
  
  
  
"statusId": "string",
  
  
  
"statusName": "string",
  
  
  
"tags": [
  
  
  
  
{
  
  
  
  
  
"group": "string",
  
  
  
  
  
"value": "string"
  
  
  
  
}
  
  
  
],
  
  
  
"totalPlacementCount": 0,
  
  
  
"twitter": "string",
  
  
  
"updatedOn": "string",
  
  
  
"website": "string"
  
  
}
  
],
  
"error": "string",
  
"message": "string",
  
"page": 0,
  
"requestId": "string",
  
"size": 0,
  
"success": true,
  
"total": 0
}

Playground

Authorization
Variables
Key
Value

Samples

Recruitly — Recruitment CRM for Agencies