Skip to content

List jobs by client​

GET
/api/nova/public/jobs/client/{companyId}

Returns all jobs linked to the client company given by the companyId path variable, for the tenant identified by the PUBLIC-role apiKey query parameter. The optional includeArchived flag (default false) also includes archived jobs in the results. Each job is returned as a NovaPublicJobResponse with the advert fields, recruiter contact details and a public apply URL. An invalid apiKey returns 401.

Authorizations​

publicApiKey
Type
API Key (query: apiKey)

Parameters​

Path Parameters

companyId*

companyId

Type
string
Required

Query Parameters

apiKey*

apiKey

Type
string
Required
includeArchived

includeArchived

Type
boolean
Default
false

Responses​

OK

application/json
JSON
{
  
"data": [
  
  
{
  
  
  
"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"
  
  
  
}
  
  
}
  
],
  
"message": "string",
  
"metadata": {
  
},
  
"success": true,
  
"totalCount": 0,
  
"totalValue": 0
}

Playground​

Authorization
Variables
Key
Value

Samples​

Recruitly — Recruitment CRM for Agencies