Candidates

List candidates

Changed on

Returns the candidates (board users with role candidate) of the authenticated account. Per-candidate saved-job and alert counts are not inlined here. Fetch them via GET /v1/candidates/{id}. Requires candidates.read.

get/candidates

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/candidates
  • Auth: HTTP bearer

Query parameters

cursorstring

Pagination cursor.

limitinteger

Page size (1–100, default 50).

searchstring

Case-insensitive substring match on the candidate email or display name.

handlestring

Exact public-profile handle lookup.

hasResume'true' | 'false'

Filter by whether the candidate has uploaded a resume.

createdFromstring date-time

ISO-8601 lower bound (inclusive) on registration date.

createdTostring date-time

ISO-8601 upper bound (inclusive) on registration date.

Response

Successful response.

object'list' required
urlstring required
hasMoreboolean required
nextCursorstring nullable required

Example response

{
  "url": "/v1/candidates"
}

Changes