List Keka Employees
keka_list_employeesRetrieve a paginated employee list from Keka HRM. Filter by employment status, employee IDs, search key, probation, or notice period, and get details in markdown or JSON.
Instructions
Retrieve a paginated list of employees from Keka HRM.
Supports filtering by employment status, employee IDs, probation status, notice period, and a free-text search key.
Args:
employmentStatus (string, optional): Filter by status — 'Active', 'InActive', 'Terminated', 'NotJoined'
employeeIds (string, optional): Comma-separated employee IDs to fetch specific employees
searchKey (string, optional): Free-text search across name, email, employee number
inProbation (boolean, optional): Filter employees currently in probation
inNoticePeriod (boolean, optional): Filter employees in notice period
pageNumber (integer): Page number, starting at 1 (default: 1)
pageSize (integer): Results per page, max 200 (default: 100)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: Paginated list of employees with ID, name, email, department, job title, status, and join date.
Examples:
List all active employees → employmentStatus='Active'
Find a specific person → searchKey='John Doe'
Get employees by IDs → employeeIds='emp1,emp2,emp3'
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pageSize | No | Results per page (max 200) | |
| searchKey | No | Free-text search across name, email, or employee number | |
| pageNumber | No | Page number (starts at 1) | |
| employeeIds | No | Comma-separated list of employee IDs | |
| inProbation | No | Filter for employees in probation | |
| inNoticePeriod | No | Filter for employees in notice period | |
| response_format | No | Output format: 'markdown' for human-readable, 'json' for machine-readable | markdown |
| employmentStatus | No | Filter by employment status |