---
title: "/candidates"
method: GET
path: "/c/{company_id}/candidates"
---

# /candidates

`GET /c/{company_id}/candidates`

## Request

- Base URL: `https://api.recruitee.com`
- URL: `https://api.recruitee.com/c/{company_id}/candidates`
- Auth: OAuth 2

Calling the `/candidates` endpoint will return a collection of the company's candidates. If `limit` and `offset` are not provided, all candidates will be returned.

This endpoint hits the database directly, so getting the response might take some time, depending on the number of candidates.

WARNING:
For searching candidates it is advised to use `/search/new/candidates` endpoint for better performance.

## Path parameters

- `company_id` integer, required

## Query parameters

- `limit` integer
- `offset` integer
- `created_after` string, date-time
- `disqualified` boolean
- `qualified` boolean
- `ids` string
- `offer_id` string
- `query` string
- `sort` string
- `with_messages` boolean
- `with_my_messages` boolean

## Response `200`

200

- object
  - `candidates` object[]
    - `admin_id` unknown
    - `adminapp_url` string
    - `created_at` string
    - `emails` string[]
    - `example` boolean
    - `followed` boolean
    - `id` integer
    - `last_message_at` unknown
    - `my_last_rating` unknown
    - `my_pending_result_request` boolean
    - `my_upcoming_event` boolean
    - `name` string
    - `notes_count` integer
    - `pending_result_request` boolean
    - `phones` unknown[]
      - unknown
    - `photo_thumb_url` string
    - `placements` object[]
      - `candidate_id` integer
      - `created_at` string
      - `id` integer
      - `language` object
        - `code` string
        - `name` string
        - `native_name` string
      - `offer_id` integer
      - `overdue_at` unknown
      - `overdue_diff` unknown
      - `position` integer
      - `stage_id` integer
      - `updated_at` string
    - `positive_ratings` unknown
    - `rating` integer
    - `ratings` object
    - `ratings_count` integer
    - `referrer` unknown
    - `source` string
    - `tasks_count` integer
    - `unread_notifications` boolean
    - `upcoming_event` boolean
    - `updated_at` string
    - `viewed` boolean
  - `generated_at` string
  - `limit` integer
  - `offset` integer
  - `references` object[]
    - `id` integer
    - `kind` string
    - `lang_code` string
    - `location` string
    - `position` integer
    - `slug` string
    - `status` string
    - `title` string
    - `type` string

## Other responses

- `401`: 401

---

[API](https://skmtc.dev/recruitee/apis/ats-api.md) - [All operations](https://skmtc.dev/recruitee/apis/ats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recruitee/apis/ats-api/revisions/92a80d21a7e0?raw)