Skip to content

Get record by ID

GET
/api/nova/records/{recordId}

Looks up any system record (candidate, contact, company, job and other record types) by the recordId path parameter and returns a lightweight summary regardless of type. The response contains the record's id, type, label (display name), email, mobile and reference. Useful for resolving an unknown record id to its type before calling the type-specific endpoints. Returns 404 if the record is not found, and 401 if the API key is invalid.

Authorizations

privateApiKey
Type
API Key (query: apiKey)

Parameters

Path Parameters

recordId*

recordId

Type
string
Required

Query Parameters

apiKey*

apiKey

Type
string
Required

Responses

OK

application/json
JSON
{
  
"data": {
  
},
  
"error": "string",
  
"message": "string",
  
"requestId": "string",
  
"success": true
}

Playground

Authorization
Variables
Key
Value

Samples

Recruitly — Recruitment CRM for Agencies