---
title: "List candidates"
method: GET
path: "/recruitment/candidates"
tags: ["Candidates"]
---

# List candidates

`GET /recruitment/candidates`

## Query parameters

- `pipeline_stage_id` integer
- `skills[]` string
- `vacancy_ids[]` integer
- `email` string
- `created_at[gte]` string
- `created_at[lte]` string
- `updated_at[gte]` string
- `updated_at[lte]` string
- `page` integer

## Response `200`

OK

- object
  - `data` CandidateSimple[]
    - `id` string, required
    - `full_name` string, required
    - `email` string
    - `phone_numbers` string[]
    - `date_of_birth` string
    - `position` string
    - `urls` string[]
    - `skills` string[]
    - `location` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `gender` string
    - `source` string
    - `level` string
    - `desired_salary` integer
    - `currency_code` string
    - `last_contacted_at` string
    - `cover_letter` string
    - `resume` boolean
    - `tags` string[]
    - `languages` object[]
      - `id` integer
      - `code` string
      - `level` string
    - `created_by` ReportingTo
      - `id` integer, required
      - `first_name` string
      - `last_name` string
      - `email` string, email, required
    - `applications` object[]
      - `id` integer, required
      - `disqualified_at` string, date-time
      - `vacancy` object
        - `id` integer
        - `title` string
      - `pipeline_state` object
        - `id` integer
        - `name` string
      - `disqualify_reason` object
        - `id` integer
        - `name` string
  - `metadata` Pagination
    - `page` integer
    - `pages` integer
    - `count` integer
    - `items` integer

---

[API](https://skmtc.net/peopleforce/apis/company-api.md) · [All operations](https://skmtc.net/peopleforce/apis/company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peopleforce/company-api/versions/ff612e61a4c3/schema)