Reads all Employees

get

https://api.factorialhr.com/api/2026-10-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

Return only the employees with these ids. Ids outside what the reader may see are dropped, rather than failing the whole read.

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

Return only the employees whose contract is under these legal entities.

legal_entity_ids[]

company_identifier

string

filter by employee company identifier.

only_active

boolean

required

Set to true to keep only the employees not terminated as of today: those with no termination date, or one still in the future. Passing false has no effect, and it is ignored altogether when include_active_and_terminated is set.

team_ids[]

array of strings

Return only the employees who belong to these teams.

team_ids[]

location_ids[]

array of strings

Return only the employees whose default workplace is one of these locations.

location_ids[]

only_managers

boolean

required

Set to true to return only the employees who have at least one direct report. Passing false has no effect.

name_starts_with

string

filter by employee names that start with the given text.

Response

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK