Skip to content

Get a job​

GET
/api/nova/jobs/{jobId}

Fetches a single job by its ID, passed as a path variable, and returns the full job record including title, descriptions, status, company, contact, tags and custom fields. Requires the apiKey query parameter. Returns 404 if no job with the given ID exists in the account, 401 for an invalid API key, and 500 with an error message on failure.

Authorizations​

privateApiKey
Type
API Key (query: apiKey)

Parameters​

Path Parameters

jobId*

jobId

Type
string
Required

Query Parameters

apiKey*

apiKey

Type
string
Required

Responses​

OK

application/json
JSON
{
  
"data": {
  
  
"clientBrief": "string",
  
  
"closingDate": "string",
  
  
"companyId": "string",
  
  
"companyName": "string",
  
  
"contactId": "string",
  
  
"contactName": "string",
  
  
"createdOn": "string",
  
  
"customFields": [
  
  
  
{
  
  
  
  
"boolValue": "string",
  
  
  
  
"dateValue": "string",
  
  
  
  
"fieldId": "string",
  
  
  
  
"fieldLabel": "string",
  
  
  
  
"listValue": [
  
  
  
  
  
"string"
  
  
  
  
],
  
  
  
  
"value": "string"
  
  
  
}
  
  
],
  
  
"dateOpened": "string",
  
  
"employmentTypeId": "string",
  
  
"employmentTypeName": "string",
  
  
"experienceLevelId": "string",
  
  
"experienceLevelName": "string",
  
  
"flexiHours": true,
  
  
"hot": true,
  
  
"id": "string",
  
  
"internalDescription": "string",
  
  
"lastActivityDate": "string",
  
  
"location": "string",
  
  
"maxPay": 0,
  
  
"minPay": 0,
  
  
"openPositions": 0,
  
  
"ownerId": "string",
  
  
"ownerName": "string",
  
  
"payCurrency": "string",
  
  
"payTenure": "string",
  
  
"rating": 0,
  
  
"reference": "string",
  
  
"relocation": true,
  
  
"remoteWorking": true,
  
  
"shortDescription": "string",
  
  
"skills": [
  
  
  
"string"
  
  
],
  
  
"sourceId": "string",
  
  
"sourceName": "string",
  
  
"startDate": "string",
  
  
"statusId": "string",
  
  
"statusName": "string",
  
  
"statusReason": "string",
  
  
"tags": [
  
  
  
{
  
  
  
  
"group": "string",
  
  
  
  
"value": "string"
  
  
  
}
  
  
],
  
  
"title": "string",
  
  
"updatedOn": "string",
  
  
"visaSponsored": true
  
},
  
"error": "string",
  
"message": "string",
  
"requestId": "string",
  
"success": true
}

Playground​

Authorization
Variables
Key
Value

Samples​

Recruitly — Recruitment CRM for Agencies