Appearance
List published jobs
GET
/api/nova/public/jobs
Returns the tenant's open jobs for display on a public job board or website. This is a public endpoint authenticated only by a PUBLIC-role apiKey query parameter; an invalid key returns 401, and a disabled or under-review tenant returns an empty result. Supports optional location and country filters plus pageNumber, pageSize (default 20) and paginated query parameters for paging. Each job is returned as a NovaPublicJobResponse: the advert fields, recruiter contact details and a public apply URL.
Authorizations
publicApiKey
Type
API Key (query: apiKey)
Parameters
Query Parameters
apiKey*
apiKey
Type
Requiredstring
country
country
Type
string
industries
industries
Type
string
jobTypes
jobTypes
Type
string
keywords
keywords
Type
string
location
location
Type
string
pageNumber
pageNumber
Type
integer
Format
"int32"Default
0pageSize
pageSize
Type
integer
Format
"int32"Default
20paginated
paginated
Type
boolean
Default
falsesectors
sectors
Type
string
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
{
}