Sign in

v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB
Ats > Candidate

Reads a single Candidate

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.

get/api/2026-07-01/resources/ats/candidates/{id}

Path parameters

idstring required

list of candidate identifiers.

Response

OK

idstring required

identifier of the candidate.

company_idstring

company identifier.

first_namestring required

name of the candidate.

last_namestring required

last name of the candidate.

full_namestring required

full name of the candidate.

emailstring

email of the candidate.

talent_poolboolean required

is the candidate part of talent pool?

phone_numberstring

phone number of the candidate.

created_atstring required

creation date of the candidate.

updated_atstring required

last update of the candidate.

consent_given_atstring

date when the consent was given.

inactive_sincestring

date when the candidate became inactive.

ats_job_posting_idsstring[]

list of job posting identifiers.

personal_urlstring

personal web resource from the candidate.

consent_expiration_datestring

date when the consent expires.

consent_to_talent_poolboolean

consent to talent pool.

mediumstring

specifies additional details related to the source of the candidate, such as the referrer name for example if the source is referred.

source_idstring

candidate source identifier, refers to ats/candidate_sources endpoint.

gender'female' | 'male' | 'unanswered' | 'other'

gender of the candidate.

scorenumber

score of the candidate.

Example response

{
  "id": "1",
  "company_id": "1",
  "first_name": "Ana",
  "last_name": "Fernandez Perez",
  "full_name": "Ana Fernandez Perez",
  "email": "ana@factorial.com",
  "talent_pool": true,
  "created_at": "2021-01-01T00:00:00Z",
  "updated_at": "2021-01-01T00:00:00Z",
  "consent_given_at": "2021-01-01T00:00:00Z",
  "inactive_since": "2021-01-01T00:00:00Z",
  "ats_job_posting_ids": [
    "1",
    "2",
    "3"
  ],
  "personal_url": "https://anaperez.factorial.com",
  "consent_expiration_date": "2021-01-01T00:00:00Z",
  "consent_to_talent_pool": true,
  "medium": "email",
  "source_id": "1",
  "gender": "female",
  "score": 7
}