Rankings & Candidates

Manage job rankings and evaluate candidates.

List Rankings

Retrieve a list of all job rankings.

Endpoint: GET /rankings

Example Request

curl -X GET "https://api.usejuno.io/v1/developer/rankings" \
  -H "X-API-Key: your_api_key_here"

Response

[
  {
    "id": "ranking_123",
    "jobTitle": "Frontend Engineer",
    "jobDescription": "..."
  }
]

Create Ranking

Create a new job ranking to start evaluating candidates.

Endpoint: POST /rankings

Request Body

Field	Type	Required	Description
`jobTitle`	string	Yes	The title of the open position.
`jobDescription`	string	Yes	The full job description text.

Example Request

curl -X POST "https://api.usejuno.io/v1/developer/rankings" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jobTitle": "Backend Engineer",
    "jobDescription": "We need a Node.js expert..."
  }'

Response

{
  "description": "Ranking created"
}

View Candidates

Get a list of candidates processed for a specific ranking.

Endpoint: GET /rankings/{rankingId}/candidates

Path Parameters

Parameter	Type	Required	Description
`rankingId`	string	Yes	The ID of the job ranking.

Example Request

curl -X GET "https://api.usejuno.io/v1/developer/rankings/ranking_123/candidates" \
  -H "X-API-Key: your_api_key_here"

Response

[
  {
    "name": "Jane Doe",
    "email": "jane@example.com",
    "score": 85,
    "summary": "Strong candidate..."
  }
]

Hire Candidate

Mark a candidate as hired for a specific ranking.

Endpoint: POST /rankings/{rankingId}/candidates/{applicantEmail}/hire

Path Parameters

Parameter	Type	Required	Description
`rankingId`	string	Yes	The ID of the job ranking.
`applicantEmail`	string	Yes	The email of the candidate to hire.

Example Request

curl -X POST "https://api.usejuno.io/v1/developer/rankings/ranking_123/candidates/jane@example.com/hire" \
  -H "X-API-Key: your_api_key_here"

Response

{
  "description": "Candidate hired successfully"
}