---
title: "Returns a list of existing candidates."
method: GET
path: "/recruiting/candidates"
tags: ["Recruiting"]
---

# Returns a list of existing candidates.

`GET /recruiting/candidates`

This endpoint will return a paginated list of candidates. The query params will help to filter the results. Results will include custom fields, if any.

## Query parameters

- `_id` string
- `firstName` string
- `lastName` string
- `email` string
- `sourceField` string
- `privacyPolicyAccepted` boolean
- `limit` 25 | 50 | 100
- `offset` number

## Response `200`

OK. Paginated list of candidates.

- object
  - `data` object[]
    - `_id` string — The unique identifier of the person.
    - `firstName` string — The first name of the person.
    - `lastName` string — The last name of the person.
    - `email` string — The email address of the person.
    - `phone` string — The phone number of the person (optional).
    - `origin` string — The source of the entry (e.g., API, manual, agency, browserExtension).
    - `_createdById` string — The unique identifier of the creator of the record.
    - `_updatedById` string — The unique identifier of the updater of the record.
    - `_createdAt` string, date-time — The creation date of the record in ISO 8601 format.
    - `_updatedAt` string, date-time — The last update date of the record in ISO 8601 format.
  - `metadata` object
    - `limit` number — The maximum number of items per page.
    - `offset` number — The starting point of the data retrieval.
    - `total` number — The total number of items available.
    - `count` number — The number of items retrieved in the current response.

## Other responses

- `400` — BAD REQUEST. This is a wrong request in the client side due to invalid body or params.
- `401` — UNAUTHORIZED. The Authorization header is incorrect, not provided or the token expired.

---

[API](https://skmtc.net/kenjo/apis/kenjo-api.md) · [All operations](https://skmtc.net/kenjo/apis/kenjo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kenjo/kenjo-api/revisions/58772b78268e/schema)