Get top candidates
GET /api/v1/hiring/{process_id}/candidates
Retrieve the top-ranked candidates for a hiring process.
Authorizations
Parameters
Path Parameters
Query Parameters
Responses
200
Successful Response
Typed envelope for GET /{process_id}/candidates.
object
Response body listing the top-ranked candidates for a hiring process.
Attributes: candidates: Ordered list of screening results, best candidates first.
object
Top candidates sorted by recommendation tier then fit score
Response body for a candidate screening result.
Attributes: candidate_id: UUID of the screened candidate. fit_score: Overall fit score from 0 to 100. recommendation: Overall recommendation (recommend, maybe, pass). strengths: Key strengths identified for this role. concerns: Areas of concern about the candidate. reasoning: Detailed reasoning behind the recommendation.
object
ID of the screened candidate
Areas of concern about this candidate
Overall fit score from 0 to 100
Detailed reasoning behind the recommendation
Overall recommendation: recommend, maybe, or pass
Candidate’s key strengths for this role
Standard metadata attached to every API response.
object
Unique request identifier
Server timestamp of the response
422
Validation Error