---
title: "Get Talent pool candidates"
method: GET
path: "/v1/hire/talentpool/{talentPoolId}/candidates"
tags: ["TalentPool"]
---

# Get Talent pool candidates

`GET /v1/hire/talentpool/{talentPoolId}/candidates`

## Request

- Base URL: `https://{company}.keka.com/api`
- URL: `https://{company}.keka.com/api/v1/hire/talentpool/{talentPoolId}/candidates`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://login.kekad.com/connect/token`

Get candidates in a specified talent pool

## Path parameters

- `talentPoolId` string, required

## Query parameters

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

## Response `200`

Success

- TalentPoolCandidateDTO[]
  - `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 | 4 | 5
  - `email` string, nullable: Gets or sets the email.
  - `phone` string, nullable: Gets or sets the 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.
  - `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
  - `talentPoolDetails` object, nullable

## Other responses

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

---

[API](https://skmtc.dev/keka/apis/keka-hire-api.md) - [All operations](https://skmtc.dev/keka/apis/keka-hire-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keka/apis/keka-hire-api/revisions/fcf1c09be7ce?raw)