---
title: "Information on candidates"
method: GET
path: "/candidate"
tags: ["Candidate"]
---

# Information on candidates

`GET /candidate`

## Query parameters

- `page` integer
- `per_page` integer
- `responsible_recruiter_id` integer
- `vacancy_id` integer
- `stage_id` integer
- `source` integer
- `vacancy_sources` integer

## Headers

- `token` string, required

## Response `200`

ОК

- CandidateListResponse — Information on candidates
  - `result` object
    - `current_page` integer
    - `data` ApiV1CandidateListResource[]
      - `id` integer
      - `name` string
      - `source` integer — not selected = 0, LinkedIn = 1, Work.ua = 2, Rabota.ua = 3, HeadHunter(HH) = 4, Dou.ua = 5, Djinni.co = 6, Inco.works = 7, Recruiter chats = 8, Recomendation = 9, Emploee recomendation = 10, Corporate website = 11, Personal appeal = 12, other = 13, Facebook = 14, Recruitment agency = 15, Public vacancy = 16, SuperJob = 17 Habr Career = 18
      - `position` string
      - `gender` integer — not selected = 0, Male = 1, Female = 2
      - `current_positions` string
      - `wish_positions` string
      - `salary` object
        - `min_salary` integer
        - `max_salary` integer
        - `currency_code` string
      - `experience` object
        - `experience_code` integer
        - `experience` string
      - `work_types` object[]
        - `type` integer
        - `name` string
      - `status_ids` integer[]
      - `blacklist` integer
      - `languages` object[]
        - `language_id` integer
        - `name` string
        - `level` integer
      - `contacts` object[]
        - `type` integer
        - `value` string
      - `tags` object[]
        - string
      - `recommended` object[]
        - `id` integer
        - `name` string
      - `responsible_recruiters` object[]
        - `id` integer
        - `name` string
      - `vacancies` object[]
        - `id` integer
        - `stage_id` integer
      - `custom_properties` ApiV1CandidateCustomPropertiesResourceItem[]
        - `id` integer
        - `name` string
        - `properties` union[]
          - union
            - ApiV1CandidateCustomPropertyResourceItemArray — Блок значения custom property
              - …
            - ApiV1CandidateCustomPropertyResourceItemString — Блок значения custom property
              - …
            - ApiV1CandidateCustomPropertyResourceItemInteger — Блок значения custom property
              - …
    - `first_page_url` string
    - `from` integer
    - `last_page` integer
    - `last_page_url` string
    - `next_page_url` string, nullable
    - `path` string, nullable
    - `per_page` integer
    - `prev_page_url` string, nullable
    - `to` integer
    - `total` integer
  - `error` boolean
  - `code` integer
  - `messages` string[]

## Other responses

- `403` — Forbidden
- `422` — Invalid request parameters

---

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