---
title: "Reads all Candidates"
method: GET
path: "/api/2026-07-01/resources/ats/candidates"
tags: ["Ats > Candidate"]
---

# Reads all Candidates

`GET /api/2026-07-01/resources/ats/candidates`

Fetches candidates data from Factorial. When using administrator-level API Credentials, all candidates associated with a company will be returned. When using non-admin level API credentials, only candidates that applied to a job for which the user is a hiring manager will be returned.

## Query parameters

- `ids[]` string[] — list of candidate identifiers.
- `emails[]` string[] — list of candidate emails.
- `team_ids[]` string[] — list of team identifiers, refers to teams/teams endpoint.
- `location_ids[]` string[] — list of location identifiers, refers to locations/locations endpoint.
- `source[]` string[] — source of the candidate.
- `remote` boolean — is the candidate remote?
- `job_posting_ids[]` string[] — list of job posting identifiers, refers to ats/job_postings endpoint.
- `minimum_average_rating` number — minimum average rating of the candidate.
- `active` boolean — is the candidate active?
- `talent_pool` boolean — is the candidate part of talent pool?
- `archived` boolean — is the candidate archived?

## Response `200`

OK

- object
  - `data` AtsCandidate[]
    - `id` string, required — identifier of the candidate.
    - `company_id` string — company identifier.
    - `first_name` string, required — name of the candidate.
    - `last_name` string, required — last name of the candidate.
    - `full_name` string, required — full name of the candidate.
    - `email` string — email of the candidate.
    - `talent_pool` boolean, required — is the candidate part of talent pool?
    - `phone_number` string — phone number of the candidate.
    - `created_at` string, required — creation date of the candidate.
    - `updated_at` string, required — last update of the candidate.
    - `consent_given_at` string — date when the consent was given.
    - `inactive_since` string — date when the candidate became inactive.
    - `ats_job_posting_ids` string[] — list of job posting identifiers.
    - `personal_url` string — personal web resource from the candidate.
    - `consent_expiration_date` string — date when the consent expires.
    - `consent_to_talent_pool` boolean — consent to talent pool.
    - `medium` string — specifies additional details related to the source of the candidate, such as the referrer name for example if the source is referred.
    - `source_id` string — candidate source identifier, refers to ats/candidate_sources endpoint.
    - `gender` 'female' | 'male' | 'unanswered' | 'other' — gender of the candidate.
    - `score` number — score of the candidate.
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

---

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