Request

GET https://api.comeet.co/candidates

Filter by Candidate properties

These filters apply to the candidate object, which represents an individual hiring process.

status - comma separated list of statuses. Return candidates who match any of the provided values. values.
status=In%20progress,Rejected
time_created:before - Return candidates for which the time_created time_created is BEFORE the provided time. time.
time_created:before=2018-01-01T12:50:50Z
time_created:after - Return candidates for which the time_created time_created is AFTER the provided time. time.
time_created:after=2018-01-01T12:50:50Z
time_last_status_change:before - Return candidates for which the time_last_status_change time_last_status_change is BEFORE the provided time. time.
time_last_status_change:before=2018-01-01T12:50:50Z
time_last_status_change:after - Return candidates for which the time_last_status_change time_last_status_change is AFTER the provided time. time.
time_last_status_change:after=2018-01-01T12:50:50Z
time_hiring_process_updated:before - Return candidates that had any activity BEFORE the provided time. time.
time_hiring_process_updated:before=2018-01-01T12:50:50Z
time_hiring_process_updated:after - Return candidates that had any activity AFTER the provided time. time.
time_hiring_process_updated:after=2018-01-01T12:50:50Z
- deleted - True or False - True returns deleted candidates, False excludes deleted candidates. candidates.
  deleted=True/False

Filter by Person properties

These filters apply to the person object, which represents all of the hiring processes (candidate objects) associated with the same person.

time_person_last_activity:before - Return candidates for which the last activity is BEFORE the provided time. This filter takes into account all of the candidate objects that are associated with the same person. person.
time_person_last_activity:before=2018-01-01T12:50:50Z
time_person_last_activity:after - Return candidates for which the last activity is AFTER the provided time. This filter takes into account all of the candidate objects that are associated with the same person. person.
time_person_last_activity:after=2018-01-01T12:50:50Z

Response

{
"candidates":[
{
"uid":"00.AAA",
"deleted": false,
"position_uid":"11.11",
"time_created":"2018-01-01T12:50:50Z",
"time_last_status_changed":"2018-01-01T12:50:50Z",
"current_steps":[
{
"name":"Technical interview",
"type":"In person Interview",
"time_scheduled":"2018-01-01T12:50:50Z"
} //...
],
"completed_steps":[
{
"name":"CV Screen",
"type":"Go/No-go",
"time_scheduled":"2018-01-01T12:50:50Z",
"time_completed":"2018-03-03T12:50:50Z"
} //...
],
"address":{
"country": "US",
"state": "NY",
"zip": "11249",
"street_address": "109 S 5th St",
"city": "Brooklyn"
},
"status":"In progress"
} //...
],
// URL or null if no more candidates available
"next_page": "https://api.comeet.co/..."
}