Skip to content

Get a published job​

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

Fetches a single job for the tenant identified by the PUBLIC-role apiKey query parameter. The jobId path variable accepts either the job's internal id or, when it starts with JB-, the job's reference (e.g. JB-123). Returns the job as a NovaPublicJobResponse with the advert fields, recruiter contact details and a public apply URL. Responds with 404 if no matching job exists and 401 if the apiKey is invalid.

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
{
  
"applyEmail": "string",
  
"applyUrl": "string",
  
"archived": true,
  
"bannerImage": {
  
  
"id": "string",
  
  
"name": "string",
  
  
"url": "string"
  
},
  
"benefits": [
  
  
"string"
  
],
  
"companyName": "string",
  
"cutOffDate": "dd/MM/yyyy",
  
"description": "string",
  
"employmentType": "string",
  
"estClosingDate": "dd/MM/yyyy",
  
"experience": "string",
  
"hot": true,
  
"id": "string",
  
"industries": [
  
  
{
  
  
  
"id": "string",
  
  
  
"name": "string"
  
  
}
  
],
  
"industry": "string",
  
"jobDetailImage": {
  
  
"id": "string",
  
  
"name": "string",
  
  
"url": "string"
  
},
  
"jobType": "string",
  
"keepAdvertWhenClosed": true,
  
"languages": [
  
  
{
  
  
  
"code": "string",
  
  
  
"level": "string",
  
  
  
"name": "string"
  
  
}
  
],
  
"location": {
  
  
"addressLabel": "string",
  
  
"addressLine": "string",
  
  
"cityName": "string",
  
  
"cityRegion": "string",
  
  
"country": "string",
  
  
"countryCode": "string",
  
  
"countryName": "string",
  
  
"latitude": 0,
  
  
"longitude": 0,
  
  
"postCode": "string",
  
  
"regionName": "string"
  
},
  
"openings": 0,
  
"ownerId": "string",
  
"ownerName": "string",
  
"packageOverview": "string",
  
"pay": {
  
  
"currency": {
  
  
  
"code": "string",
  
  
  
"name": "string"
  
  
},
  
  
"label": "string",
  
  
"maxPay": 0,
  
  
"minPay": 0,
  
  
"range": true,
  
  
"tenure": {
  
  
  
"code": "string",
  
  
  
"name": "string"
  
  
}
  
},
  
"postedOn": "dd/MM/yyyy",
  
"publishToWebsite": true,
  
"recruiter": {
  
  
"address": {
  
  
  
"addressLabel": "string",
  
  
  
"addressLine": "string",
  
  
  
"cityName": "string",
  
  
  
"cityRegion": "string",
  
  
  
"country": "string",
  
  
  
"countryCode": "string",
  
  
  
"countryName": "string",
  
  
  
"latitude": 0,
  
  
  
"longitude": 0,
  
  
  
"postCode": "string",
  
  
  
"regionName": "string"
  
  
},
  
  
"email": "string",
  
  
"fullName": "string",
  
  
"headline": "string",
  
  
"id": "string",
  
  
"initials": "string",
  
  
"languages": [
  
  
  
"string"
  
  
],
  
  
"linkedIn": "string",
  
  
"mobile": "string",
  
  
"profilePicUrl": "string",
  
  
"workPhone": "string"
  
},
  
"reference": "string",
  
"remoteWorking": true,
  
"sector": "string",
  
"sectors": [
  
  
{
  
  
  
"id": "string",
  
  
  
"name": "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