List employees

GET/hr/employees

Returns a paginated list of all employees with their associated branch, department, and position. Use for directory lookups, HR reports, or to populate dropdowns in other HR features.

Request

This endpoint takes no parameters and no request body.

Responses

200 Paginated employee list

Content type application/json, object.

Field	Type	Required	Description
data	array of object · EmployeeV1	No
data[].id	integer	No	Auto-incremented primary key.
data[].first_name	string	No	Employee's given name. Example: "Ama"
data[].last_name	string	No	Employee's family name. Example: "Owusu"
data[].email	string (email)	No	Work email address. Example: "a.owusu@example.test"
data[].department_id	integer, nullable	No	ID of the assigned HR department.
data[].position_id	integer, nullable	No	ID of the assigned HR position.
data[].branch_id	integer, nullable	No	ID of the assigned branch location.
data[].status	string	No	Employment status. One of: "active", "inactive", "terminated" · Example: "active"
data[].hire_date	string (date), nullable	No	Date the employee was hired. Example: "2026-04-08"

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/hr/employees" \
  -H "Accept: application/json"