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.

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

Selected candidate fields in response

Field nameDescription
admin_id ID of user who created the candidate
emails Array of email addresses
followed True if token owner follows the candidate
name Candidate name
phones Array of candidate phone numbers
placements Array of assignments to jobs or talent pools with stage information
Click Try It! to start a request and see the response here!