GuidesAPI ReferenceChangelog
API Reference
These docs are for v2025-10-01. Click to read the latest docs for v2026-04-01.

Reads all Candidates

get
https://api.factorialhr.com/api/2025-10-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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
ids[]
array of integers

list of candidate identifiers.

ids[]
emails[]
array of strings

list of candidate emails.

emails[]
team_ids[]
array of integers

list of team identifiers, refers to teams/teams endpoint.

team_ids[]
location_ids[]
array of integers

list of location identifiers, refers to locations/locations endpoint.

location_ids[]
source[]
array of strings

source of the candidate.

source[]
boolean

is the candidate remote?

job_posting_ids[]
array of integers

list of job posting identifiers, refers to ats/job_postings endpoint.

job_posting_ids[]
number

minimum average rating of the candidate.

boolean

is the candidate active?

boolean

is the candidate part of talent pool?

boolean

is the candidate archived?

Response

Updated 7 months ago

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 months ago