When using the HackerRank API to review candidates who have taken a test, the returned JSON will contain a couple of integer value fields that correspond to a candidate's status in the HackerRank workflow. The fields are named "status" and "ats_state". Below you will find an explanation of what they mean.
status
This field gives the status of the actual attempt itself and can be used to determine if the candidate has started to take the test or completed it. Here are the values it can take and what they mean:
| Value | Meaning |
| -1 | Candidate invited |
| 0 | Test in progress |
| 1 | Test finished |
| 2 | Internal state, ignore |
| 3 | Internal state, ignore |
| 4 | Internal state, ignore |
| 5 | Internal state, ignore |
| 6 | Test attempt visible in app |
| 7 | Test completion email sent to the user, candidate marked as "Completed" in app |
ats_state
Once a candidate completes a test, their state in the recruitment process can be updated on the HackerRank platform to correspond to states often found in Applicant Tracking System (ATS) tools like Taleo and Greenhouse. A candidate can be automatically progressed to a further state if a cut-off score has been configured, or a recruiter can manually move the candidate to a different state to indicate that the candidate is worthy of progressing to a later stage in the hiring process.
This state is captured in the ats_state field in the response. The mappings from the integer code to the different values they signify are in the table below:
| Value | ATS State |
| 0 | ATS state not set |
| 1 | Test Completed - Evaluation Required |
| 2 | Test Completed - Qualified |
| 3 | Test Completed - Failed |
| 4 | Phone Interview - I |
| 5 | Phone Interview - II |
| 6 | Phone Interview - III |
| 7 | Offer Sent |
| 8 | Offer Negotiation |
| 9 | Offer Accepted |
| 10 | Offer Declined |
| 11 | On Hold |
| 12 | Phone Interview - Cleared |
| 13 | Phone Interview - Failed |
| 14 | Technical Interview - Cleared |
| 15 | Technical Interview - Failed |
| 16 | HR Interview - Cleared |
| 17 | HR Interview - Failed |
| 18 | Phone Interview |
| 19 | Technical Interview |
| 20 | HR Interview |
| 21 | Hired |
| 22 | Rejected |