Skip to content

List Employees

Endpoint

http
GET /unified/hris/employees
Integrations supported
  • Google Workspace
  • greytHR
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
  • Okta
  • Repute
  • Zoho People
  • Zwayam
Partial response integrations

For partial response integrations, you will need to fetch the individual resource using the "get" endpoint to get the full response object.

  • Google Workspace
  • greytHR
  • HiBob
  • Okta
  • Repute
  • Zoho People
  • Zwayam

Query parameters

integrated_account_id
string · uuid
REQUIRED · The ID of the integrated account to use for the request.
Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d
employment_status
string
This represents the employment status. If no clear mapping is available, then the raw value is returned.
All possible enum values:
  • active
  • all
  • inactive
  • newHire
Enum support by integration
  • HiBob
    • active
    • all
  • Humaans
    • active
    • inactive
    • all
    • newHire
  • greytHR
    • active
    • inactive
    • all
  • Keka
    • active
    • inactive
Supported in
  • greytHR
  • HiBob
  • Humaans
  • Keka
created_at
string
This represents the date when the Employee was created
Supported in
  • HR Cloud
  • Humaans
updated_at
string
This represents the date when the Employee was updated
Supported in
  • greytHR
  • HR Cloud
  • Humaans
  • Keka
  • Repute
  • Zoho People

Response Body

result
object[]
List of Employees
id
string
REQUIRED · The unique identifier for employees
Supported in
  • Google Workspace
  • greytHR
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
  • Okta
  • Repute
  • Zoho People
  • Zwayam
employee_number
string
This represents the employee number
Supported in
  • Google Workspace
  • greytHR
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
  • Okta
  • Zoho People
company
object
This represents the company
Supported in
  • HiBob
id
string
The unique identifier for companies
first_name
string
This represents the first name of the employee
Supported in
  • Google Workspace
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
  • Okta
  • Zoho People
  • Zwayam
last_name
string
This represents the last name of the employee
Supported in
  • Google Workspace
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
  • Okta
  • Zoho People
  • Zwayam
name
string
This represents the name of the employee
Supported in
  • Google Workspace
  • greytHR
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
  • Okta
  • Repute
  • Zoho People
username
string
This represents the username
Supported in
  • Okta
groups
object[]
This represents the groups
Supported in
  • Google Workspace
  • greytHR
  • Hailey HR
  • HiBob
  • Humaans
  • Keka
  • Okta
  • Zoho People
id
string
The unique identifier for groups
name
string
Group's name
type
string
Type of the group. Some underlying providers use this to differentiate between in-built and user created groups.
emails
object[]
The emails of the user
Supported in
  • Google Workspace
  • greytHR
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
  • Okta
  • Repute
  • Zoho People
  • Zwayam
email
string
The email address
type
string
The type of email address
is_primary
boolean
Whether the email address is primary
phones
object[]
The phones of the user
Supported in
  • Google Workspace
  • greytHR
  • Hailey HR
  • HR Cloud
  • Humaans
  • Keka
  • Okta
  • Repute
  • Zoho People
number
string
The phone number
type
string
The type of phone number
employments
object[]
Represents a role or employment of the employee in the company
Supported in
  • HiBob
  • Keka
  • Repute
  • Zoho People
id
string
REQUIRED · The unique identifier for employments
employee
object
Employee associated with this employment
id
string
The unique identifier for employees
job_title
string
Job title of the employee
pay_rate
number
This represents the pay rate
pay_period
string
This represents the pay period
pay_frequency
string
This represents the pay frequency
pay_currency
string
This represents the pay currency
pay_group
string
This represents the pay group
flsa_status
string
This represents the flsa status
effective_date
string · date-time
Represents the effective date of the employment
end_date
string · date-time
Represents the end date of the employment
employment_type
string
This represents the employment type
All possible enum values:
  • full_time
  • part_time
  • contract
  • internship
  • temporary
  • trainee
  • volunteer
  • per_diem
end_reason
string
Represents why the employment ended
created_at
string
This represents the date when the employments was created
updated_at
string
This represents the date when the employments was updated
home_location
object[]
This represents the home location
Supported in
  • Hailey HR
  • HR Cloud
  • Humaans
  • Keka
  • Zoho People
id
string
The unique identifier for locations
name
string
This represents the name of the location
street_1
string
The first line of home address
street_2
string
The second line of home address
city
string
The city of the home address
state
string
The state/province of the home address
postal_code
string
The postal code of the home address
country
string
The country of the home address
work_location
object
This represents the work location
Supported in
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Zoho People
id
string
The unique identifier for locations
name
string
This represents the name of the location
street_1
string
The first line of work address
street_2
string
The second line of work address
city
string
The city of the work address
state
string
The state/province of the work address
postal_code
string
The postal code of the work address
country
string
The country of the work address
manager
object
Represents the manager of the employee. Is also an employee.
Supported in
  • Google Workspace
  • greytHR
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
  • Zoho People
id
string
The unique identifier for employees
name
string
This represents the name of the employee
pay_group
object
This represents the pay group
Supported in
  • Keka
id
string
The unique identifier for pay groups
ssn
string
This represents the ssn
gender
string
This represents gender
Supported in
  • greytHR
  • Hailey HR
  • HR Cloud
  • Humaans
  • Keka
  • Repute
  • Zoho People
ethnicity
string
This represent ethnicity
Supported in
  • HR Cloud
marital_status
string
This represents marital status
Supported in
  • Keka
  • Zoho People
date_of_birth
string
This represents date of birth
Supported in
  • greytHR
  • Hailey HR
  • HR Cloud
  • Humaans
  • Keka
  • Repute
  • Zoho People
start_date
string
This represents the start date
Supported in
  • greytHR
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
  • Okta
  • Zoho People
employment_status
string
This represents the employment status. If no clear mapping is available, then the raw value is returned.
All possible enum values:
  • active
  • inactive
Supported in
  • greytHR
  • Hailey HR
  • Humaans
  • Keka
  • Okta
  • Repute
  • Zoho People
termination_date
string
This represents the termination date
Supported in
  • greytHR
  • Hailey HR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
  • Zoho People
termination_type
string
Represents the type of termination. If no clear mapping exists, then raw value is returned.
All possible enum values:
  • voluntary
  • dismissed
  • redundancy
  • end_of_contract
  • retirement
  • mutual
Supported in
  • HiBob
  • Humaans
  • Keka
termination_reason
string
Represents the reason for termination
Supported in
  • greytHR
  • HiBob
  • HR Cloud
  • Humaans
  • Keka
avatar
string
This represents the avatar
Supported in
  • HiBob
  • Humaans
  • Keka
  • Zoho People
created_at
string
This represents the date when the Employee was created
Supported in
  • Google Workspace
  • HiBob
  • HR Cloud
  • Humaans
  • Okta
  • Zoho People
updated_at
string
This represents the date when the Employee was updated
Supported in
  • greytHR
  • HR Cloud
  • Humaans
  • Okta
  • Zoho People
  • Zwayam
remote_data
object
Raw data returned from the remote API call.
next_cursor
string
The cursor to use for the next page of results. Pass this value as `next_cursor` in the query parameter in the next request to get the next page of results.