Skip to content

Get contact by ID​

GET
/api/nova/contacts/{contactId}

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

Authorizations​

privateApiKey
Type
API Key (query: apiKey)

Parameters​

Path Parameters

contactId*

contactId

Type
string
Required

Query Parameters

apiKey*

apiKey

Type
string
Required

Responses​

OK

application/json
JSON
{
  
"data": {
  
  
"alternateEmail": "string",
  
  
"companyId": "string",
  
  
"companyName": "string",
  
  
"createdOn": "string",
  
  
"customFields": [
  
  
  
{
  
  
  
  
"boolValue": "string",
  
  
  
  
"dateValue": "string",
  
  
  
  
"fieldId": "string",
  
  
  
  
"fieldLabel": "string",
  
  
  
  
"listValue": [
  
  
  
  
  
"string"
  
  
  
  
],
  
  
  
  
"value": "string"
  
  
  
}
  
  
],
  
  
"dateOfBirth": "string",
  
  
"description": "string",
  
  
"doNotContact": true,
  
  
"email": "string",
  
  
"facebook": "string",
  
  
"firstName": "string",
  
  
"homePhone": "string",
  
  
"id": "string",
  
  
"industries": [
  
  
  
"string"
  
  
],
  
  
"jobTitle": "string",
  
  
"lastActivityDate": "string",
  
  
"lastName": "string",
  
  
"linkedIn": "string",
  
  
"location": "string",
  
  
"mobile": "string",
  
  
"ownerId": "string",
  
  
"ownerName": "string",
  
  
"reference": "string",
  
  
"secondaryCompanyId": "string",
  
  
"secondaryCompanyName": "string",
  
  
"sectors": [
  
  
  
"string"
  
  
],
  
  
"skills": [
  
  
  
"string"
  
  
],
  
  
"skype": "string",
  
  
"sourceId": "string",
  
  
"sourceName": "string",
  
  
"statusId": "string",
  
  
"statusName": "string",
  
  
"tags": [
  
  
  
{
  
  
  
  
"group": "string",
  
  
  
  
"value": "string"
  
  
  
}
  
  
],
  
  
"twitter": "string",
  
  
"updatedOn": "string",
  
  
"workPhone": "string"
  
},
  
"error": "string",
  
"message": "string",
  
"requestId": "string",
  
"success": true
}

Playground​

Authorization
Variables
Key
Value

Samples​

Recruitly — Recruitment CRM for Agencies