Skip to content

Get a job by ID or reference

GET
/api/nova/public/jobs/{jobId}

Pass either the job's ObjectId or its reference (e.g. JB-123).

Authorizations

publicApiKey
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
{
  
"aiInstruction": "string",
  
"applyEmail": "string",
  
"applyUrl": "string",
  
"archived": true,
  
"bannerImage": {
  
  
"bucket": "string",
  
  
"category": "string",
  
  
"categoryId": "string",
  
  
"categoryName": "string",
  
  
"contentType": "string",
  
  
"createdOn": "string",
  
  
"defaultDisplayFileInPortal": true,
  
  
"docType": true,
  
  
"expiresOn": "dd/MM/yyyy",
  
  
"fileSize": 0,
  
  
"id": "string",
  
  
"imageType": true,
  
  
"key": "string",
  
  
"modifiedOn": "string",
  
  
"name": "string",
  
  
"owner": {
  
  
  
"address": {
  
  
  
  
"addressLabel": "string",
  
  
  
  
"addressLine": "string",
  
  
  
  
"addressLine2": "string",
  
  
  
  
"cityName": "string",
  
  
  
  
"cityNameLower": "string",
  
  
  
  
"cityOrRegionAndPostCode": "string",
  
  
  
  
"cityRegion": "string",
  
  
  
  
"country": "string",
  
  
  
  
"countryCode": "string",
  
  
  
  
"countryCodeLower": "string",
  
  
  
  
"countryName": "string",
  
  
  
  
"fullAddressLine": "string",
  
  
  
  
"geoCodingLine": "string",
  
  
  
  
"hasAddressLine": true,
  
  
  
  
"hasCity": true,
  
  
  
  
"hasCityOrRegion": true,
  
  
  
  
"hasCountry": true,
  
  
  
  
"hasCountryCode": true,
  
  
  
  
"hasPostcode": true,
  
  
  
  
"hasRegion": true,
  
  
  
  
"hasValidGeo": true,
  
  
  
  
"latitude": 0,
  
  
  
  
"longitude": 0,
  
  
  
  
"postCode": "string",
  
  
  
  
"regionName": "string",
  
  
  
  
"shortAddressLine": "string"
  
  
  
},
  
  
  
"alternateEmail": "string",
  
  
  
"cvId": "string",
  
  
  
"doNotContact": true,
  
  
  
"email": "string",
  
  
  
"employerName": "string",
  
  
  
"hasCv": true,
  
  
  
"headline": "string",
  
  
  
"homePhone": "string",
  
  
  
"id": "string",
  
  
  
"inSpecificJob": true,
  
  
  
"initials": "string",
  
  
  
"jobPipelines": [
  
  
  
  
{
  
  
  
  
  
"jobId": "string",
  
  
  
  
  
"jobReference": "string",
  
  
  
  
  
"pipelineStatus": "string",
  
  
  
  
  
"placed": true,
  
  
  
  
  
"rejected": true,
  
  
  
  
  
"subStatus": "string"
  
  
  
  
}
  
  
  
],
  
  
  
"label": "string",
  
  
  
"labels": [
  
  
  
  
{
  
  
  
  
  
"bgColor": "string",
  
  
  
  
  
"filterId": "string",
  
  
  
  
  
"id": "string",
  
  
  
  
  
"message": "string",
  
  
  
  
  
"name": "string",
  
  
  
  
  
"ownerId": "string",
  
  
  
  
  
"parentLabelId": "string",
  
  
  
  
  
"parentLabelName": "string",
  
  
  
  
  
"position": 0,
  
  
  
  
  
"shared": true,
  
  
  
  
  
"sharedSelectedUsers": true,
  
  
  
  
  
"sharedWith": [
  
  
  
  
  
  
{
  
  
  
  
  
  
  
"email": "string",
  
  
  
  
  
  
  
"id": "string",
  
  
  
  
  
  
  
"name": "string",
  
  
  
  
  
  
  
"profileImageUrl": "string",
  
  
  
  
  
  
  
"recordId": "string",
  
  
  
  
  
  
  
"reference": "string",
  
  
  
  
  
  
  
"tenantId": "string",
  
  
  
  
  
  
  
"type": "string"
  
  
  
  
  
  
}
  
  
  
  
  
],
  
  
  
  
  
"success": true,
  
  
  
  
  
"textColor": "string",
  
  
  
  
  
"type": "string"
  
  
  
  
}
  
  
  
],
  
  
  
"linkedIn": "string",
  
  
  
"mobile": "string",
  
  
  
"ownerId": "string",
  
  
  
"ownerName": "string",
  
  
  
"params": {
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"profileImageUrl": "string",
  
  
  
"rating": 0,
  
  
  
"recordType": "string",
  
  
  
"reference": "string",
  
  
  
"tenantId": "string",
  
  
  
"tenantName": "string",
  
  
  
"website": "string",
  
  
  
"workPhone": "string"
  
  
},
  
  
"reference": "string",
  
  
"shared": true,
  
  
"showInClientPortal": true,
  
  
"signed": {
  
  
  
"expiresOn": 0,
  
  
  
"signedUrl": "string"
  
  
},
  
  
"url": "string",
  
  
"visibleToRecord": true
  
},
  
"benefits": [
  
  
"string"
  
],
  
"clientBrief": "string",
  
"companyName": "string",
  
"cutOffDate": "dd/MM/yyyy",
  
"description": "string",
  
"employmentType": "string",
  
"estClosingDate": "dd/MM/yyyy",
  
"experience": "string",
  
"hot": true,
  
"id": "string",
  
"industries": [
  
  
{
  
  
  
"category": "string",
  
  
  
"color": "string",
  
  
  
"createdBy": "string",
  
  
  
"id": "string",
  
  
  
"masterDataType": "string",
  
  
  
"message": "string",
  
  
  
"name": "string",
  
  
  
"position": 0,
  
  
  
"reasons": [
  
  
  
  
{
  
  
  
  
  
"defaultReason": true,
  
  
  
  
  
"id": "string",
  
  
  
  
  
"name": "string",
  
  
  
  
  
"orderNumber": 0,
  
  
  
  
  
"statusId": "string"
  
  
  
  
}
  
  
  
],
  
  
  
"success": true,
  
  
  
"synonyms": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"tenantId": "string",
  
  
  
"type": {
  
  
  
  
"code": "string",
  
  
  
  
"id": "string",
  
  
  
  
"name": "string"
  
  
  
},
  
  
  
"userName": "string",
  
  
  
"values": [
  
  
  
  
"string"
  
  
  
]
  
  
}
  
],
  
"industry": "string",
  
"internalDescription": "string",
  
"jobDetailImage": {
  
  
"bucket": "string",
  
  
"category": "string",
  
  
"categoryId": "string",
  
  
"categoryName": "string",
  
  
"contentType": "string",
  
  
"createdOn": "string",
  
  
"defaultDisplayFileInPortal": true,
  
  
"docType": true,
  
  
"expiresOn": "dd/MM/yyyy",
  
  
"fileSize": 0,
  
  
"id": "string",
  
  
"imageType": true,
  
  
"key": "string",
  
  
"modifiedOn": "string",
  
  
"name": "string",
  
  
"owner": {
  
  
  
"address": {
  
  
  
  
"addressLabel": "string",
  
  
  
  
"addressLine": "string",
  
  
  
  
"addressLine2": "string",
  
  
  
  
"cityName": "string",
  
  
  
  
"cityNameLower": "string",
  
  
  
  
"cityOrRegionAndPostCode": "string",
  
  
  
  
"cityRegion": "string",
  
  
  
  
"country": "string",
  
  
  
  
"countryCode": "string",
  
  
  
  
"countryCodeLower": "string",
  
  
  
  
"countryName": "string",
  
  
  
  
"fullAddressLine": "string",
  
  
  
  
"geoCodingLine": "string",
  
  
  
  
"hasAddressLine": true,
  
  
  
  
"hasCity": true,
  
  
  
  
"hasCityOrRegion": true,
  
  
  
  
"hasCountry": true,
  
  
  
  
"hasCountryCode": true,
  
  
  
  
"hasPostcode": true,
  
  
  
  
"hasRegion": true,
  
  
  
  
"hasValidGeo": true,
  
  
  
  
"latitude": 0,
  
  
  
  
"longitude": 0,
  
  
  
  
"postCode": "string",
  
  
  
  
"regionName": "string",
  
  
  
  
"shortAddressLine": "string"
  
  
  
},
  
  
  
"alternateEmail": "string",
  
  
  
"cvId": "string",
  
  
  
"doNotContact": true,
  
  
  
"email": "string",
  
  
  
"employerName": "string",
  
  
  
"hasCv": true,
  
  
  
"headline": "string",
  
  
  
"homePhone": "string",
  
  
  
"id": "string",
  
  
  
"inSpecificJob": true,
  
  
  
"initials": "string",
  
  
  
"jobPipelines": [
  
  
  
  
{
  
  
  
  
  
"jobId": "string",
  
  
  
  
  
"jobReference": "string",
  
  
  
  
  
"pipelineStatus": "string",
  
  
  
  
  
"placed": true,
  
  
  
  
  
"rejected": true,
  
  
  
  
  
"subStatus": "string"
  
  
  
  
}
  
  
  
],
  
  
  
"label": "string",
  
  
  
"labels": [
  
  
  
  
{
  
  
  
  
  
"bgColor": "string",
  
  
  
  
  
"filterId": "string",
  
  
  
  
  
"id": "string",
  
  
  
  
  
"message": "string",
  
  
  
  
  
"name": "string",
  
  
  
  
  
"ownerId": "string",
  
  
  
  
  
"parentLabelId": "string",
  
  
  
  
  
"parentLabelName": "string",
  
  
  
  
  
"position": 0,
  
  
  
  
  
"shared": true,
  
  
  
  
  
"sharedSelectedUsers": true,
  
  
  
  
  
"sharedWith": [
  
  
  
  
  
  
{
  
  
  
  
  
  
  
"email": "string",
  
  
  
  
  
  
  
"id": "string",
  
  
  
  
  
  
  
"name": "string",
  
  
  
  
  
  
  
"profileImageUrl": "string",
  
  
  
  
  
  
  
"recordId": "string",
  
  
  
  
  
  
  
"reference": "string",
  
  
  
  
  
  
  
"tenantId": "string",
  
  
  
  
  
  
  
"type": "string"
  
  
  
  
  
  
}
  
  
  
  
  
],
  
  
  
  
  
"success": true,
  
  
  
  
  
"textColor": "string",
  
  
  
  
  
"type": "string"
  
  
  
  
}
  
  
  
],
  
  
  
"linkedIn": "string",
  
  
  
"mobile": "string",
  
  
  
"ownerId": "string",
  
  
  
"ownerName": "string",
  
  
  
"params": {
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"profileImageUrl": "string",
  
  
  
"rating": 0,
  
  
  
"recordType": "string",
  
  
  
"reference": "string",
  
  
  
"tenantId": "string",
  
  
  
"tenantName": "string",
  
  
  
"website": "string",
  
  
  
"workPhone": "string"
  
  
},
  
  
"reference": "string",
  
  
"shared": true,
  
  
"showInClientPortal": true,
  
  
"signed": {
  
  
  
"expiresOn": 0,
  
  
  
"signedUrl": "string"
  
  
},
  
  
"url": "string",
  
  
"visibleToRecord": true
  
},
  
"jobType": "string",
  
"languages": [
  
  
{
  
  
  
"code": "string",
  
  
  
"level": {
  
  
  
  
"code": "string",
  
  
  
  
"name": "string",
  
  
  
  
"orderNumber": 0
  
  
  
},
  
  
  
"name": "string"
  
  
}
  
],
  
"location": {
  
  
"addressLabel": "string",
  
  
"addressLine": "string",
  
  
"addressLine2": "string",
  
  
"cityName": "string",
  
  
"cityNameLower": "string",
  
  
"cityOrRegionAndPostCode": "string",
  
  
"cityRegion": "string",
  
  
"country": "string",
  
  
"countryCode": "string",
  
  
"countryCodeLower": "string",
  
  
"countryName": "string",
  
  
"fullAddressLine": "string",
  
  
"geoCodingLine": "string",
  
  
"hasAddressLine": true,
  
  
"hasCity": true,
  
  
"hasCityOrRegion": true,
  
  
"hasCountry": true,
  
  
"hasCountryCode": true,
  
  
"hasPostcode": true,
  
  
"hasRegion": true,
  
  
"hasValidGeo": true,
  
  
"latitude": 0,
  
  
"longitude": 0,
  
  
"postCode": "string",
  
  
"regionName": "string",
  
  
"shortAddressLine": "string"
  
},
  
"openings": 0,
  
"ownerId": "string",
  
"ownerName": "string",
  
"packageOverview": "string",
  
"pay": {
  
  
"candidateRate": 0,
  
  
"currency": {
  
  
  
"code": "string",
  
  
  
"id": "string",
  
  
  
"name": "string",
  
  
  
"symbol": "string"
  
  
},
  
  
"daysPerWeek": 0,
  
  
"endDate": "yyyy-MM-dd",
  
  
"endTime": "string",
  
  
"hoursPerDay": 0,
  
  
"jobEndDate": "string",
  
  
"jobPayLabel": "string",
  
  
"jobStartDate": "string",
  
  
"label": "string",
  
  
"maxPay": 0,
  
  
"minPay": 0,
  
  
"onCosts": 0,
  
  
"payLabel": "string",
  
  
"payRate": 0,
  
  
"range": true,
  
  
"startDate": "yyyy-MM-dd",
  
  
"startTime": "string",
  
  
"tenure": {
  
  
  
"code": "string",
  
  
  
"id": "string",
  
  
  
"name": "string"
  
  
}
  
},
  
"postedOn": "dd/MM/yyyy",
  
"publishToWebsite": true,
  
"recruiter": {
  
  
"address": {
  
  
  
"addressLabel": "string",
  
  
  
"addressLine": "string",
  
  
  
"addressLine2": "string",
  
  
  
"cityName": "string",
  
  
  
"cityOrRegionAndPostCode": "string",
  
  
  
"cityRegion": "string",
  
  
  
"country": "string",
  
  
  
"countryCode": "string",
  
  
  
"countryName": "string",
  
  
  
"hasCity": true,
  
  
  
"hasCityOrRegion": true,
  
  
  
"hasCountry": true,
  
  
  
"hasPostcode": true,
  
  
  
"hasRegion": true,
  
  
  
"hasValidGeo": true,
  
  
  
"latitude": 0,
  
  
  
"longitude": 0,
  
  
  
"postCode": "string",
  
  
  
"regionName": "string"
  
  
},
  
  
"aiAgent": true,
  
  
"archived": true,
  
  
"calendarColor": "string",
  
  
"createdOn": "string",
  
  
"disabled": true,
  
  
"email": "string",
  
  
"emailConnected": true,
  
  
"fullName": "string",
  
  
"headline": "string",
  
  
"id": "string",
  
  
"initials": "string",
  
  
"languages": [
  
  
  
"string"
  
  
],
  
  
"linkedIn": "string",
  
  
"masterDataPrivileges": [
  
  
  
"string"
  
  
],
  
  
"mobile": "string",
  
  
"modifiedOn": "string",
  
  
"modules": [
  
  
  
"string"
  
  
],
  
  
"nickname": "string",
  
  
"office": {
  
  
  
"address": {
  
  
  
  
"addressLabel": "string",
  
  
  
  
"addressLine": "string",
  
  
  
  
"addressLine2": "string",
  
  
  
  
"cityName": "string",
  
  
  
  
"cityOrRegionAndPostCode": "string",
  
  
  
  
"cityRegion": "string",
  
  
  
  
"country": "string",
  
  
  
  
"countryCode": "string",
  
  
  
  
"countryName": "string",
  
  
  
  
"hasCity": true,
  
  
  
  
"hasCityOrRegion": true,
  
  
  
  
"hasCountry": true,
  
  
  
  
"hasPostcode": true,
  
  
  
  
"hasRegion": true,
  
  
  
  
"hasValidGeo": true,
  
  
  
  
"latitude": 0,
  
  
  
  
"longitude": 0,
  
  
  
  
"postCode": "string",
  
  
  
  
"regionName": "string"
  
  
  
},
  
  
  
"id": "string",
  
  
  
"name": "string",
  
  
  
"phone": "string"
  
  
},
  
  
"privileges": {
  
  
  
"anonymise": true,
  
  
  
"bulkEmail": true,
  
  
  
"bulkSms": true,
  
  
  
"deleteData": true,
  
  
  
"deleteEmails": true,
  
  
  
"exportData": true,
  
  
  
"invoiceReconciliation": true
  
  
},
  
  
"profilePicUrl": "string",
  
  
"role": "string",
  
  
"teamId": "string",
  
  
"teamName": "string",
  
  
"timeZone": "string",
  
  
"twoFactorEnforced": true,
  
  
"uniqueId": 0,
  
  
"workPhone": "string"
  
},
  
"recruitingTeam": {
  
  
"members": [
  
  
  
{
  
  
  
  
"email": "string",
  
  
  
  
"id": "string",
  
  
  
  
"initials": "string",
  
  
  
  
"name": "string",
  
  
  
  
"owner": true,
  
  
  
  
"profileImageUrl": "string",
  
  
  
  
"role": "string"
  
  
  
}
  
  
]
  
},
  
"reference": "string",
  
"remoteWorking": true,
  
"scorecardTemplate": {
  
  
"createdOn": "string",
  
  
"generatedFrom": "string",
  
  
"groups": [
  
  
  
{
  
  
  
  
"attributes": [
  
  
  
  
  
{
  
  
  
  
  
  
"id": "string",
  
  
  
  
  
  
"label": "string"
  
  
  
  
  
}
  
  
  
  
],
  
  
  
  
"category": "string",
  
  
  
  
"name": "string"
  
  
  
}
  
  
],
  
  
"modifiedByUserEmail": "string",
  
  
"modifiedOn": "string"
  
},
  
"sector": "string",
  
"sectors": [
  
  
{
  
  
  
"category": "string",
  
  
  
"color": "string",
  
  
  
"createdBy": "string",
  
  
  
"id": "string",
  
  
  
"masterDataType": "string",
  
  
  
"message": "string",
  
  
  
"name": "string",
  
  
  
"position": 0,
  
  
  
"reasons": [
  
  
  
  
{
  
  
  
  
  
"defaultReason": true,
  
  
  
  
  
"id": "string",
  
  
  
  
  
"name": "string",
  
  
  
  
  
"orderNumber": 0,
  
  
  
  
  
"statusId": "string"
  
  
  
  
}
  
  
  
],
  
  
  
"success": true,
  
  
  
"synonyms": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"tenantId": "string",
  
  
  
"type": {
  
  
  
  
"code": "string",
  
  
  
  
"id": "string",
  
  
  
  
"name": "string"
  
  
  
},
  
  
  
"userName": "string",
  
  
  
"values": [
  
  
  
  
"string"
  
  
  
]
  
  
}
  
],
  
"shortDescription": "string",
  
"skills": [
  
  
"string"
  
],
  
"status": "string",
  
"tags": [
  
  
{
  
  
  
"key": "string",
  
  
  
"value": "string"
  
  
}
  
],
  
"tenantId": "string",
  
"title": "string",
  
"uniqueId": 0,
  
"webAdvert": {
  
  
"coreSkills": "string",
  
  
"keyLanguages": "string",
  
  
"mainResponsibilities": "string",
  
  
"recruitmentProcess": "string",
  
  
"whatWillYouLearn": "string",
  
  
"whatsOnOffer": "string"
  
}
}

Playground

Authorization
Variables
Key
Value

Samples

Recruitly — Recruitment CRM for Agencies