Jobs
Manage jobs and job applications.
Work in progress: Endpoint names may use both
jobsandrankingswhile Juno continues to consolidate this surface. In Juno, a job and a ranking refer to the same underlying record.
List Jobs
Retrieve a list of jobs for your partner account.
Endpoint: GET /rankings
curl -X GET "https://api.usejuno.io/v1/developer/rankings" \
-H "X-API-Key: your_api_key_here"
View Job
Retrieve one job that belongs to your partner account.
Endpoint: GET /jobs/{jobId}
| Parameter | Type | Required | Description |
|---|---|---|---|
jobId | string | Yes | The ID of the job/ranking. |
curl -X GET "https://api.usejuno.io/v1/developer/jobs/job_123" \
-H "X-API-Key: your_api_key_here"
Apply To Job
Submit one candidate application with one resume file. This endpoint accepts multipart/form-data and has an additional application-specific rate limit of 20 requests per minute per API key per job.
The API validates the job before processing the uploaded file. Jobs that are closed, expired, archived, or not configured for the job board will not accept applications.
Endpoint: POST /jobs/{jobId}/applications
| Field | Type | Required | Description |
|---|---|---|---|
resume | file | Yes | Resume file, up to 15MB. |
candidateEmail | string | Yes | Candidate email address. |
candidateName | string | No | Candidate full name. |
linkedinUrl | string | No | Candidate LinkedIn URL. |
portfolioUrl | string | No | Candidate portfolio URL. |
coverLetterUrl | string | No | Cover letter URL. |
questionAnswers | string | No | JSON encoded array of custom question answers. |
aptitudeQuestionAnswers | string | No | JSON encoded array of aptitude question answers. |
utmSource | string | No | UTM source. |
utmMedium | string | No | UTM medium. |
utmCampaign | string | No | UTM campaign. |
referrer | string | No | Referrer URL or label. |
curl -X POST "https://api.usejuno.io/v1/developer/jobs/job_123/applications" \
-H "X-API-Key: your_api_key_here" \
-F "resume=@/path/to/resume.pdf" \
-F "candidateEmail=jane@example.com" \
-F "candidateName=Jane Doe" \
-F 'questionAnswers=[{"questionId":"question_123","answer":"Yes"}]'
Close Job
Close a job so it stops accepting applications.
Endpoint: PATCH /jobs/{jobId}/close
| Field | Type | Required | Description |
|---|---|---|---|
closedReason | string | No | Reason for closing the job. |
curl -X PATCH "https://api.usejuno.io/v1/developer/jobs/job_123/close" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"closedReason": "Role filled"
}'
Related Resources
- Applicants - View applicants, scores, decisions, and stage movement.
- Interviews - Invite applicants, view interview summaries, and manage scorecards.