Get Candidate Application Status

Endpoint 3 – Get a Candidate Application Status

GET /postings/:uuid/candidates/:candidateId/status

Use this endpoint to get the application status of a specific candidate against a specific job and expose it in your interface so the candidate can see what status they are in for the job.

  • “X-SmartToken” HTTP header should be added for each request.
  • Endpoint accepts the Posting UUID and Candidate Id as path params. The Candidate Id is returned as part of the candidate object when creating a candidate.

Endpoint returns the following example object

{
    "status": "IN-REVIEW",
}
PropertyDefinition
NEWCandidate Applied
IN-REVIEWCandidate is being reviewed by the hiring team
INTERVIEWCandidate is being interviewed by the hiring team
OFFERCandidate received an offer
HIRECandidate was hired
REJECTEDCandidate was rejected
WITHDRAWNCandidate has withdrawn interest
LEADCandidate is considered for the job but has not applied
TRANSFERREDCandidate has been transferred away from the job to another