Skip to content

List jobs

GET
/api/nova/jobs/list

Lists jobs in the account by running the job search with an empty query, so both open and closed jobs are returned. Query parameters are apiKey (required) plus page and size for the response metadata; size is capped at 100. The response contains the jobs with page, size and total count. Returns 401 for an invalid API key and 500 with an error message on failure.

Authorizations

privateApiKey
Type
API Key (query: apiKey)

Parameters

Query Parameters

apiKey*

apiKey

Type
string
Required
page

page

Type
integer
Format
"int32"
Default
0
size

size

Type
integer
Format
"int32"
Default
20

Responses

OK

application/json
JSON
{
  
"data": [
  
  
{
  
  
  
"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",
  
"page": 0,
  
"requestId": "string",
  
"size": 0,
  
"success": true,
  
"total": 0
}

Playground

Authorization
Variables
Key
Value

Samples

Recruitly — Recruitment CRM for Agencies