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.

  • One of authorization headers must be present in each request (Authentication).
    • If you are using OAuth 2.0 authentication then candidate_applications_manage scope is required
  • The endpoint requires the Posting UUID as a path parameter. It is obtained from Posting API.
  • The endpoint requires the Candidate UUID as a path parameter. It is obtained after Post an Application.

Example response

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