The candidate object represents a hiring process. A single person can have multiple hiring processes with a company. This is represented by multiple candidate objects that have the same person_uid.

Field

Type

Description

uid

string

Candidate UID

person_uid

string

The candidate's person UID. Each person can have multiple candidate objects associated with it. Each candidate object represents a hiring process.

first_name

string

middle_name

string

last_name

string

email

string

phone

string

mobile_phone

string

id_number

string

linkedin_url

string

deleted

boolean

Indicates whether the candidate has been deleted. When true the candidate object will only include the uid

position_uid

string

Position UID

source_contact

object

time_created

string

Format: YYYY-MM-DDTHH:mm:ssZ

time_last_status_changed

string

Format: YYYY-MM-DDTHH:mm:ssZ

URL

string

URL of the candidate profile in Comeet

current_steps[]

array

If the candidate is In progress then this is the array of the current steps that the candidate is waiting for. If the candidate is in any other status then the array is empty.

current_steps[].name

string

current_steps[].type

string

One of the following:
Go/No-go
Phone Interview
Video Interview
In person Interview
Assessment
Administrative
Offer

current_steps[].time_scheduled

string

Time of scheduled interview. Format: YYYY-MM-DDTHH:mm:ssZ

completed_steps[]

array

completed_steps[].name

string

completed_steps[].type

string

One of the following:
Go/No-go
Phone Interview
Video Interview
In person Interview
Administrative
Assessment
Offer

completed_steps.time_scheduled

string

Format: YYYY-MM-DDTHH:mm:ssZ

completed_steps[].time_completed

string

Format: YYYY-MM-DDTHH:mm:ssZ

status

string

One of the following:
In progress
On hold
Awaiting Decision
Rejected
Withdrawn
Hired

prospect_status

string

One of the following:
Sourced
Contacted
Responded
Interested
Not interested
Do not contact

time_last_status_change

string

Format: YYYY-MM-DDTHH:mm:ssZ

resume

object

The resume object is only included when a dedicated permission is granted

resume.name

string

resume.url

string

Note that the URL to the resume file has a time limit of about an hour. If it expires, read the candidate object again to refresh the URL

address

object

address.country

string

address.state

string

address.zip

string

address.street_address

string

address.city

string

{  
  "uid": "00.AAA",
  "person_uid": "45.F61",
  "first_name": "Dave",
  "middle_name": null,
  "last_name": "Mathew",
  "email": "[email protected]",
  "phone": null,
  "mobile_phone": "051-9999999",
  "id_number": null,
  "linkedin_url": null,
  "deleted": false,
  "position_uid": "11.11",
  "time_created": "2018-01-01T12:50:50Z",
  "time_last_status_change": "2018-01-01T12:50:50Z",
  "URL": "http://app.comeet.co/app/index.html?goto_url=/can/1234",
  "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-01-01T14:50:50Z"
    }
    //...
  ],
  "status": "In progress",
  "resume": {  
    "name":"michael_rosen_cv.docx",
    "url":"https://comeet-xxx.amazonaws.com/65c0a9ff2166g"
  },
  "address":{
    "country": "US",
    "state": "NY",
    "zip": "11249",
    "street_address": "109 S 5th St",
    "city": "Brooklyn"
  }    
}