Skip to main content

Applicants

Use these endpoints to power ATS integrations. jobs and rankings route names point to the same Juno job record.

View Applicants​

Endpoint: GET /jobs/{jobId}/applicants

Legacy candidate alias:

Endpoint: GET /rankings/{rankingId}/candidates

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

View Applicant Scores​

Endpoint: GET /jobs/{jobId}/applicants/{applicantEmail}/scores

Returns the applicant record, resume ranking score, related interviews, scorecards, and final assessments.

curl -X GET "https://api.usejuno.io/v1/developer/jobs/job_123/applicants/jane@example.com/scores" \
  -H "X-API-Key: your_api_key_here"

Reject Applicant​

Endpoint: POST /jobs/{jobId}/applicants/{applicantEmail}/reject

Rejects the applicant and sends the configured rejection email.

curl -X POST "https://api.usejuno.io/v1/developer/jobs/job_123/applicants/jane@example.com/reject" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Accept Applicant​

Endpoint: POST /jobs/{jobId}/applicants/{applicantEmail}/accept

Marks the applicant as hired/accepted and sends the configured hire email.

curl -X POST "https://api.usejuno.io/v1/developer/jobs/job_123/applicants/jane@example.com/accept" \
  -H "X-API-Key: your_api_key_here"

Hire Candidate​

Existing candidate route for marking a candidate as hired.

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

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"

Move Applicant Across Stages​

Endpoint: PATCH /jobs/{jobId}/applicants/{applicantEmail}/stage

FieldTypeRequiredDescription
toStageIndexnumberYesDestination stage index.
fromStageIndexnumberNoExpected current stage index. Defaults to the applicant's current stage.
curl -X PATCH "https://api.usejuno.io/v1/developer/jobs/job_123/applicants/jane@example.com/stage" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "toStageIndex": 2
  }'
  • Jobs - List jobs, view job details, submit applications, and close jobs.
  • Interviews - Invite applicants and manage interview scorecards.