GuidesAPI ReferenceChangelog
API Reference
These docs are for v2026-01-01. Click to read the latest docs for v2026-04-01.

Reads all Employees

get
https://api.factorialhr.com/api/2026-01-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
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
ids[]
array of integers

filter by employee ids.

ids[]
access_ids[]
array of integers

filter by employee access ids.

access_ids[]
emails[]
array of strings

filter by employee emails.

emails[]
string

filter by employee name.

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 integers

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

string

filter by employee company identifier.

boolean
required

get only active employees

team_ids[]
array of integers

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

team_ids[]
location_ids[]
array of integers

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

location_ids[]
boolean
required

get only manager employees.

string

filter by employee names that start with the given text.

Response

Updated 2 months ago

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago