Candidate

Interview Status

When adding a new candidate you don’t have to set the status, in fact it will be silently ignored when you do. Instead it will automatically be set to new. From then on it will follow the flow pictured in the diagram below which also contains all possible statuses:

• new
• invited
• confirmed
• interviewing
• interviewed
• expired
• aborted
• skipped (not displayed; special status, see below)

Note

Candidates cannot access their interview in the new status.

For moving the candidate to the next status you must use the Advance Status Action.

Likewise setting the deadline attribute of a candidate will be silently ignored. Instead you must use the Set Deadline Action to change it.

Adding and inviting a new candidate therefore requires three separate requests:

1. POST new candidate record (returns a record with status new)
2. Set deadline on the newly created record (optional)
3. Advance status on the same record to transition to status invited. If no deadline was explicitly set project’s or company’s default interview period will be used to calculate interview deadline.

Refer also to the Candidate resource documentation.

Statuses description

new

Set when a candidate is first added (without being invited), missing some required fields and pending invitation to be sent.

The only possible transition from new is to invited.

invited

When status is changed to invited, it triggers an e-mail to candidate, giving access to the candidate interface (not for the recruiter), where they are able to set their password and start the interview.

When the candidate clicks on the mentioned link (in e-mail body) and sets a password, its status is changed to confirmed.

As the invitation has always a due date as a deadline, if such date comes before the candidate finishes the interview, the status is set to expired and access is blocked since then.

confirmed

This status means the candidate has set their password and accessed the interview suite at least once.

When status is confirmed and the deadline runs out the candidate starting their interview, the status is set to expired.

When the candidate starts their interview, the status is changed to interviewing. This status holds true, till the candidate finishes the interview.

interviewing

This is the candidate status during the running interview.

When candidate finishes the interview successfully, their status is set to interviewed.

If candidate interrupts the interview before the end, their status becomes aborted and access is blocked since then.

interviewed

Once the candidate finished their interview as planned, they are available for evaluation from the company staff.

expired

This status happens automatically as the deadlines time out.

A candidate with this status can always be restored back to status invited or confirmed. Their previous status is always saved for historical reasons.

aborted

When a candidate has interrupted the video interview (e.g. closes the browser while interviewing), he cannot enter the candidate interface anymore and is set to aborted. The candidate cannot be evaluated, but recruiters can reset such candidate to set him back to confirmed.

skipped (won’t interview)

The “skipped” status is a special status intended mainly for use with integrated third parties. It allows candidates to be marked that will definitely not proceed with their interview, without needing to remove them from the system. “Skipped” candidates will not receive notification mails and are not able to log into the candidate frontend.

Evaluation Status

The evaluation status can not be set because it is automatically calculated in the backend. It represents the current evaluation progress for this candidate considering all recruiters who are supposed to evaluate this candidate.

This means that the value might change when recruiters finish their evaluation for this candidate or when user roles for recruiters change.

Possible statuses are:

• pending (default)
• partial
• completed

The diagram below pictures what transitions from one status to another are possible:

Statuses description

pending

When a candidate hasn’t been completely rated yet by any Evaluator, they are set with pending evaluation status.

partial

When at least one Evaluator (but not all) has completed their rating on a candidate, the candidate is updated with partial evaluation status. That can happen also when another user is set as Evaluator to the project.

That can happen only after the Candidate got the status interviewed.

completed

When all customers designated as Evaluators have completely rated a candidate, such candidate is set with completed evaluation status. That status can be “downgraded” back to partial in case a new user is set as Evaluator in the project after that.

My Evaluation Status

Very similar to Evaluation Status, but it is only considering the evaluation progress of the currently logged in recruiter.

Possible statuses are:

• pending (default)
• completed

Statuses description

null

The logged in recruiter is not an evaluator in the project.

pending

The logged in recruiter has not submitted all required ratings for this candidate (the user may have submitted some of the required ratings).

completed

The logged in recruiter has submitted all required ratings for this candidate.