Skip to content
GET /unified/ats/candidates/{id}

Path Parameters

idstring
required·

The ID of the resource.

Example: 23423523

Query Parameters

Refer Specifying query parameters in Truto APIs

organization_idstring

The ID of the organization to filter the candidates by.

1 supported
Breezy
supported
job_idstring

The ID of the position to filter the candidates by.

1 supported1 required
Breezy
required
Show Truto-specific parameters
integrated_account_idstring · uuid
required·

The ID of the integrated account to use for the request.

Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d
truto_response_formatstring

The format of the response.

  • unified returns the response with unified mappings applied.
  • raw returns the unprocessed, raw response from the remote API.
  • normalized applies the unified mappings and returns the data in a normalized format.
  • stream returns the response as a stream, which is ideal for transmitting large datasets, files, or binary data. Using streaming mode helps to efficiently handle large payloads or real-time data flows without requiring the entire data to be buffered in memory.

Defaults to unified.

Example: unified
Possible values:
unifiedrawnormalizedstream
truto_ignore_remote_databoolean

Excludes the remote_data attribute from the response.

truto_exclude_fieldsstring[]

Array of fields to exclude from the response.

Example: truto_exclude_fields[]=id&truto_exclude_fields[]=name
remote_queryRecord<string, any>

Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.

Example: remote_query[foo]=bar

Response Body

idstring
required·

The candidate's unique identifier

23 supported
ApplicantStack
supported
Ashby
supported
BambooHR
supported
Breezy
supported
CATS
supported
Ceipal
supported
Fountain
supported
Greenhouse
supported
Homerun
supported
JazzHR
supported
JobScore
supported
Jobvite
supported
Lever
supported
Loxo
supported
Pinpoint
supported
Recruitee
supported
Recruiterflow
supported
Sage HR
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
Zoho Recruit
supported
applicationsobject[]

The candidate's applications

20 supported
ApplicantStack
supported
Ashby
supported
BambooHR
supported
Breezy
supported
CATS
supported
Fountain
supported
Greenhouse
supported
Homerun
supported
JazzHR
supported
JobScore
supported
Jobvite
supported
Lever
supported
Pinpoint
supported
Recruitee
supported
Recruiterflow
supported
Sage HR
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
applied_atstring · date-time

The date and time of the application's creation

attachmentsobject[]

The application's attachments

9 properties
idstring
required·

The attachment's unique identifier

applicationobject

The attachment's application

1 property
idstring

Unique identifier of the application

attachment_typestring

The attachment's type

candidateobject

The attachment's candidate

1 property
idstring

Unique identifier of the candidate

created_atstring · date-time

The date and time of the attachment's creation

file_namestring

The attachment's file_name

file_urlstring

The attachment's file_url

jobobject

The attachment's job

1 property
idstring

Unique identifier of the job

updated_atstring · date-time

The date and time of the attachment's last update

candidateobject

The application's candidate

1 property
idstring

Unique identifier of the candidate

created_atstring · date-time

The date and time of the application's creation

credited_toobject

The application's credited_to

4 properties
emailsobject[]
3 properties
emailstring

Email of the user

is_primaryboolean

Whether the email is primary

typestring

Type of the email

first_namestring

First name of the user

idstring

Unique identifier of the user

last_namestring

Last name of the user

current_stageobject

The application's current_stage

5 properties
created_atstring · date-time

The date and time of the application's current_stage's creation

idstring

The application's current_stage's unique identifier

jobobject

The application's current_stage's job

1 property
idstring

Unique identifier of the job

namestring

The application's current_stage's name

updated_atstring · date-time

The date and time of the application's current_stage's last update

idstring

The application's unique identifier

jobobject

The application's job

1 property
idstring

Unique identifier of the job

reject_reasonstring

The application's reject_reason

rejected_atstring · date-time

The date and time of the application's rejection

sourceobject

The application's source

2 properties
idstring

The application's source's unique identifier

namestring

The application's source's name

updated_atstring · date-time

The date and time of the application's last update

attachmentsobject[]

The candidate's attachments

16 supported
ApplicantStack
supported
Ashby
supported
BambooHR
supported
Breezy
supported
CATS
supported
Greenhouse
supported
Homerun
supported
Jobvite
supported
Loxo
supported
Pinpoint
supported
Recruitee
supported
Recruiterflow
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
idstring
required·

The attachment's unique identifier

applicationobject

The attachment's application

1 property
idstring

Unique identifier of the application

attachment_typestring

The attachment's type

candidateobject

The attachment's candidate

1 property
idstring

Unique identifier of the candidate

created_atstring · date-time

The date and time of the attachment's creation

file_namestring

The attachment's file_name

file_urlstring

The attachment's file_url

jobobject

The attachment's job

1 property
idstring

Unique identifier of the job

updated_atstring · date-time

The date and time of the attachment's last update

can_emailboolean

Whether the candidate can email

9 supported
CATS
supported
Ceipal
supported
Fountain
supported
Greenhouse
supported
Loxo
supported
Recruiterflow
supported
TalentLyft
supported
Teamtailor
supported
Zoho Recruit
supported
companystring

The candidate's company

9 supported
CATS
supported
Greenhouse
supported
Jobvite
supported
Lever
supported
Loxo
supported
Recruiterflow
supported
TalentLyft
supported
Workable
supported
Zoho Recruit
supported
created_atstring · date-time

The date and time of the phone number's creation

20 supported
ApplicantStack
supported
Ashby
supported
BambooHR
supported
Breezy
supported
CATS
supported
Fountain
supported
Greenhouse
supported
Homerun
supported
JobScore
supported
Lever
supported
Loxo
supported
Pinpoint
supported
Recruitee
supported
Recruiterflow
supported
Sage HR
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
Zoho Recruit
supported
emailsobject[]

The candidate's emails

23 supported
ApplicantStack
supported
Ashby
supported
BambooHR
supported
Breezy
supported
CATS
supported
Ceipal
supported
Fountain
supported
Greenhouse
supported
Homerun
supported
JazzHR
supported
JobScore
supported
Jobvite
supported
Lever
supported
Loxo
supported
Pinpoint
supported
Recruitee
supported
Recruiterflow
supported
Sage HR
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
Zoho Recruit
supported
emailstring

The candidate's email

typestring

The candidate's email type

first_namestring

The candidate's first_name

19 supported
ApplicantStack
supported
BambooHR
supported
CATS
supported
Ceipal
supported
Fountain
supported
Greenhouse
supported
Homerun
supported
JazzHR
supported
JobScore
supported
Jobvite
supported
Lever
supported
Pinpoint
supported
Recruiterflow
supported
Sage HR
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
Zoho Recruit
supported
is_privatestring

Whether the candidate is_private

4 supported
Greenhouse
supported
Lever
supported
SmartRecruiters
supported
Teamtailor
supported
last_interaction_atstring · date-time

The candidate's last_interaction date

7 supported
CATS
supported
Greenhouse
supported
JazzHR
supported
Lever
supported
Recruiterflow
supported
TalentLyft
supported
Zoho Recruit
supported
last_namestring

The candidate's last_name

19 supported
ApplicantStack
supported
BambooHR
supported
CATS
supported
Ceipal
supported
Fountain
supported
Greenhouse
supported
Homerun
supported
JazzHR
supported
JobScore
supported
Jobvite
supported
Lever
supported
Pinpoint
supported
Recruiterflow
supported
Sage HR
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
Zoho Recruit
supported
locationsstring[]

The candidate's locations

16 supported
ApplicantStack
supported
BambooHR
supported
Breezy
supported
CATS
supported
Greenhouse
supported
Homerun
supported
JazzHR
supported
JobScore
supported
Jobvite
supported
Lever
supported
Loxo
supported
Recruiterflow
supported
SmartRecruiters
supported
TalentLyft
supported
Workable
supported
Zoho Recruit
supported
namestring

The user's full name

21 supported
ApplicantStack
supported
Ashby
supported
BambooHR
supported
Breezy
supported
Ceipal
supported
Fountain
supported
Greenhouse
supported
Homerun
supported
JazzHR
supported
JobScore
supported
Jobvite
supported
Lever
supported
Loxo
supported
Pinpoint
supported
Recruitee
supported
Recruiterflow
supported
Sage HR
supported
SmartRecruiters
supported
TalentLyft
supported
Workable
supported
Zoho Recruit
supported
phonesobject[]

The candidate's phone numbers

23 supported
ApplicantStack
supported
Ashby
supported
BambooHR
supported
Breezy
supported
CATS
supported
Ceipal
supported
Fountain
supported
Greenhouse
supported
Homerun
supported
JazzHR
supported
JobScore
supported
Jobvite
supported
Lever
supported
Loxo
supported
Pinpoint
supported
Recruitee
supported
Recruiterflow
supported
Sage HR
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
Zoho Recruit
supported
extensionstring

The extension of the phone number

numberstring

The candidate's phone number

typestring

The candidate's phone number type

remote_dataRecord<string, any>

Raw data returned from the remote API call.

tagsobject[]

The candidate's tags

17 supported
Ashby
supported
Breezy
supported
CATS
supported
Fountain
supported
Greenhouse
supported
JobScore
supported
Lever
supported
Loxo
supported
Pinpoint
supported
Recruitee
supported
Recruiterflow
supported
Sage HR
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
Zoho Recruit
supported
idstring

The tag's unique identifier

namestring

The tag's name

titlestring

The candidate's title

10 supported
Breezy
supported
CATS
supported
Ceipal
supported
Greenhouse
supported
Jobvite
supported
Loxo
supported
Recruiterflow
supported
SmartRecruiters
supported
TalentLyft
supported
Zoho Recruit
supported
updated_atstring · date-time

The date and time of the phone number's last update

16 supported
Breezy
supported
CATS
supported
Fountain
supported
Greenhouse
supported
JobScore
supported
Jobvite
supported
Lever
supported
Loxo
supported
Pinpoint
supported
Recruitee
supported
Recruiterflow
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
Zoho Recruit
supported
urlsobject[]

The candidate's urls

14 supported
Ashby
supported
BambooHR
supported
Breezy
supported
CATS
supported
Greenhouse
supported
JazzHR
supported
JobScore
supported
Lever
supported
Recruiterflow
supported
SmartRecruiters
supported
TalentLyft
supported
Teamtailor
supported
Workable
supported
Zoho Recruit
supported
typestring

The candidate's URL type

urlstring

The candidate's URL

curl -X GET 'https://api.truto.one/unified/ats/candidates/{id}?integrated_account_id=<integrated_account_id>' \
  -H 'Authorization: Bearer <your_api_token>' \
  -H 'Content-Type: application/json'
const integratedAccountId = '<integrated_account_id>';

const response = await fetch(`https://api.truto.one/unified/ats/candidates/{id}?integrated_account_id=${integratedAccountId}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <your_api_token>',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
import requests

url = "https://api.truto.one/unified/ats/candidates/{id}"
headers = {
    "Authorization": "Bearer <your_api_token>",
    "Content-Type": "application/json",
}
params = {
    "integrated_account_id": "<integrated_account_id>"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())
import Truto from '@truto/truto-ts-sdk';

const truto = new Truto({
  token: '<your_api_token>',
});

const result = await truto.unifiedApi.get(
  'ats',
  'candidates',
  '<resource_id>',
  { integrated_account_id: '<integrated_account_id>' }
);

console.log(result);
import asyncio
from truto_python_sdk import TrutoApi

truto_api = TrutoApi(token="<your_api_token>")

async def main():
    result = await truto_api.unified_api.get(
        "ats",
        "candidates",
        "<resource_id>",
        {"integrated_account_id": "<integrated_account_id>"}
    )
    print(result)

asyncio.run(main())