List saved searches

GET

/api/nova/candidates/savedsearches

Lists the candidate saved searches available to the account. A saved search is created in the Recruitly app (Candidates grid, Save Search) and can express any filter criteria — tags, custom field values, statuses, sources, and more. Use the returned id as the savedSearchId parameter of GET /api/nova/candidates/search to retrieve only the candidates matching that search. Each entry carries the search's id, name, creator, creation date, and whether it is shared with the team. Responds with 401 for an invalid API key and 429 when the account's read rate limit is exceeded.

Authorizations

privateApiKey

Type

API Key (query: apiKey)

Parameters

Query Parameters

apiKey*

apiKey

Type

string

Required

Responses

OK

Content-Type

application/json

{

  

"data": [

  

  

{

  

  

  

"createdBy": "string",

  

  

  

"createdOn": "dd/MM/yyyy HH:mm",

  

  

  

"id": "string",

  

  

  

"name": "string",

  

  

  

"shared": true

  

  

}

  

],

  

"error": "string",

  

"message": "string",

  

"page": 0,

  

"requestId": "string",

  

"size": 0,

  

"success": true,

  

"total": 0

}

GET

/api/nova/candidates/savedsearches

Playground

Authorization

privateApiKey

Variables

Key

Value

apiKey*

Samples