Human resources · list_employees
List employees
Find an employee (name, email, team).
- Price
- included
- Requirements
- No connector
- runs on platform keys
- Human approval
- No
- read or internal write
Input
| Field | Type | Description |
|---|---|---|
| query | string | Partial name or email to search (case-insensitive) |
| department | string | Exact department name (case-insensitive) |
| status | active | onboarding | leaving | left | on_leave | all | Filter by status. Default: everyone except "left". "all" includes former employees. |
| includeLeaveBalances | boolean | Also return the latest leave balance per type (cp, rtt…) for each employee (default false) |
| limit | number | Max rows (1-200, default 50) |
Call this tool
Through the HTTP API, or from the MCP server with the run meta-tool.
curl https://api.ezyagents.fr/gateway/v1/run \
-H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
-d '{"tool":"list_employees","input":{"query":"…","department":"…","status":"active","includeLeaveBalances":true}}'$
run({ "tool": "list_employees", "input": {"query":"…","department":"…","status":"active","includeLeaveBalances":true} })