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": [
  
  
{
  
  
  
"clientBrief": "string",
  
  
  
"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