---
title: "Get Job Role Candidates"
method: GET
path: "/api/job-roles/{job_role_id}/candidates"
tags: ["Job Roles"]
---

# Get Job Role Candidates

`GET /api/job-roles/{job_role_id}/candidates`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/job-roles/{job_role_id}/candidates`
- Auth: HTTP bearer

Get all candidates for a specific job role

Returns candidates with their source, stage, and latest interview info.
Includes:
1. Candidates with interviews for this job role
2. Candidates directly added via job_role_candidates (no interview yet)

## Path parameters

- `job_role_id` string, uuid, required

## Query parameters

- `source_filter` string, nullable
- `stage_filter` string, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- JobRoleCandidatesResponse: Response with candidates for a job role
  - `candidates` JobRoleCandidateItem[], required
    - `id` string, required
    - `name` string, required
    - `email` string, nullable
    - `phone` string, nullable
    - `source` string, nullable
    - `source_details` string, nullable
    - `fit_score` integer, nullable
    - `fit_source` string, nullable
    - `stage` string, required
    - `stage_name` string, nullable
    - `interview_count` integer
    - `latest_interview` LatestInterviewInfo: Latest interview info for a candidate
      - `id` string, required
      - `status` string, nullable
      - `scheduled_at` string, date-time, nullable
      - `score` integer, nullable
      - `recommendation` string, nullable
      - `screening_score` integer, nullable
      - `interview_type` string, nullable
      - `interviewer_type` string, nullable
    - `has_resume` boolean
    - `linkedin_url` string, nullable
    - `created_at` string, date-time, required
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)