---
title: "Get job candidates"
method: GET
path: "/v1/hire/jobs/{jobId}/candidates"
tags: ["Jobs"]
---

# Get job candidates

`GET /v1/hire/jobs/{jobId}/candidates`

Get active or archived candidates in a specified job

## Path parameters

- `jobId` string, required

## Query parameters

- `isArchived` boolean
- `lastModified` string, date-time
- `pageNumber` integer
- `pageSize` integer

## Response `200`

Success

- JobCandidateDetailsDTO[]
  - `id` string, nullable
  - `firstName` string, nullable — Gets or sets the first name.
  - `lastName` string, nullable — Gets or sets the last name.
  - `middleName` string, nullable — Gets or sets the middle name.
  - `gender` 0 | 1 | 2 | 3
  - `email` string, nullable — Gets or sets the email.
  - `phone` string, nullable — Gets or sets the mobile phone.
  - `educationDetails` EducationDTO[], nullable — Gets or sets the education details.
    - `degree` string, nullable — Gets or sets the degree.
    - `branch` string, nullable — Gets or sets the branch.
    - `dateOfJoining` string, nullable — Gets or sets the date of joining.
    - `dateOfCompletion` string, nullable — Gets or sets the date of completion.
    - `university` string, nullable — Gets or sets the university.
    - `location` string, nullable — Gets or sets the location.
  - `candidateTags` Tag[], nullable — Gets or sets the candidate tags
    - `identifier` string, nullable
    - `name` string, nullable
    - `description` string, nullable
  - `experienceDetails` ExperienceDTO[], nullable — Gets or sets the experience details.
    - `companyName` string, nullable — Gets or sets the company name.
    - `designation` string, nullable — Gets or sets the designation.
    - `isCurrentlyWorking` boolean — Gets or sets a value indicating whether this instance is currently working.
    - `dateOfJoining` string, nullable — Gets or sets the date of joining.
    - `dateOfRelieving` string, nullable — Gets or sets the date of relieving.
    - `location` string, nullable — Gets or sets the location.
  - `skills` string[], nullable — Gets or sets the skills.
  - `additionalCandidateDetails` object, nullable
  - `jobApplicationDetails` JobApplicationDetailsDTO
    - `jobHiringStageId` string, nullable — Gets or sets the job hiring stage identifier.
    - `movedtoStageOn` string, nullable — Gets or sets the moved to current stage on.
    - `screeningQuestionsResponse` object, nullable — Gets or sets the screening questions.
    - `appliedOn` string, nullable — Gets or sets the applied on.
    - `status` 0 | 1 | 2 | 3 | 4
    - `sourcedBy` string, nullable — Gets or sets the sourced by.
    - `sourceTitle` string, nullable — Gets or sets the source title.
    - `assignedTo` string, nullable — Gets or sets the assigned to.
    - `assignedOn` string, nullable — Gets or sets the assigned on.
  - `archivedDetails` object, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Server Error

---

[API](https://skmtc.net/keka/apis/keka-api.md) · [All operations](https://skmtc.net/keka/apis/keka-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keka/keka-api/revisions/907ea395c885/schema)