Skip to content

Get company by ID

GET
/api/nova/companies/{companyId}

Fetches a single company record by its ID. The response contains the full company details including status, tags, source and custom fields. Returns 404 if no company exists with the given ID, and 401 for an invalid API key.

Authorizations

privateApiKey
Type
API Key (query: apiKey)

Parameters

Path Parameters

companyId*

companyId

Type
string
Required

Query Parameters

apiKey*

apiKey

Type
string
Required

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",
  
"requestId": "string",
  
"success": true
}

Playground

Authorization
Variables
Key
Value

Samples

Recruitly — Recruitment CRM for Agencies