Reads all Employees

get

https://api.factorialhr.com/api/2026-07-01/resources/employees/employees

Only admins can see all the employees' information, regular users will get a restricted version of the payload as a response based on the permission set by the admin

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

ids[]

array of strings

filter by employee ids.

ids[]

access_ids[]

array of strings

filter by employee access ids.

access_ids[]

emails[]

array of strings

filter by employee emails.

emails[]

full_text_name

string

filter by employee name.

updated_at_gteq

string

Filter employees by their latest update timestamp (updated_at), on or after this date. Only the date is considered; any time component is ignored (matching starts at 00:00:00 of the given date). Note: updated_at only stores the most recent update, so an employee updated multiple times is matched solely by its latest update, not by earlier ones.

legal_entity_ids[]

array of strings

filter by legal entity id (refereces to companies/legal_entities).

legal_entity_ids[]

company_identifier

string

filter by employee company identifier.

only_active

boolean

required

get only active employees

team_ids[]

array of strings

filter employees by team id (references to core/teams).

team_ids[]

location_ids[]

array of strings

filter employees by location id (references to locations/location).

location_ids[]

only_managers

boolean

required

get only manager employees.

name_starts_with

string

filter by employee names that start with the given text.

Response

200OK