---
title: "List HRIS Employees"
method: GET
path: "/api/v2/core/hris-systems/{systemId}/hris-employees"
tags: ["HRIS Employee"]
---

# List HRIS Employees

`GET /api/v2/core/hris-systems/{systemId}/hris-employees`

List call that returns all the employee profiles.

## Path parameters

- `systemId` string, required

## Query parameters

- `start` integer
- `limit` integer
- `filterQuery` string
- `query` string
- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- HRISEmployeeSchema
  - `locationCountry` string, nullable — The location country of the employee
  - `bonusAmount` integer, nullable — The amount of the bonus of the employee
  - `managerEmail` string, nullable — The email of the manager
  - `positionCriticality` string[], nullable — The criticality of the position of the employee
  - `bonusAmountCurrency` string, nullable — The currency of the bonus given to the employee
  - `location` string, nullable — The location of the employee
  - `badges` EmployeeBadge[], nullable — The badges of the employee
    - `badgeId` string, nullable — The id of the badge
    - `userId` string, nullable — The user id the badge belongs to.
    - `creator` string, nullable — The creator of the badge
    - `photoUrl` string, nullable — The photo url
    - `lastModifiedTs` integer, nullable — The last modified timestamp of the badge
    - `photoContent` PhotoContent
      - `extension` string, nullable — The extension of the photo
      - `content` string, nullable — The actual string content
      - `isBase64` boolean, nullable — Is the content base 64 encoded
    - `comment` string, nullable — comment on the badge
    - `title` string, nullable — The title of the badge
  - `firstName` string, nullable — First Name of employee
  - `mobility` EmployeeMobility
    - `comments` string, nullable — The comments
    - `travelPercentageMin` number, float, nullable — The min travel percentage
    - `relocationLocations` string[], nullable — The relocation locations
    - `relocation` string, nullable — The relocation information
    - `travel` string, nullable — The travel detail
    - `travelPercentageMax` number, float, nullable — The max travel percentage
  - `bu` string, nullable — The Business unit of the employee
  - `email` string, nullable — List of Emails of the employee comma seperated
  - `bonusAmountFrequency` string, nullable — The frequency of the bonus pay to the employee
  - `basePayCurrency` string, nullable — The currency of the base pay of the employee
  - `basePay` Pay
    - `frequency` string, nullable — The frequency of pay
    - `amount` number, float, nullable — The amount of pay
    - `currency` string, nullable — The currency of pay in ISO format
  - `level` string, nullable — The job level of the employee
  - `userId` string, nullable — The userId of the employee
  - `lastReviewRating` string, nullable — The last review rating of the employee
  - `additionalManagers` AdditionalManager[], nullable — The additional managers of the employee
    - `capacityManagerEmail` string, nullable — The email of the capacity manager
    - `employeeId` string, nullable — Employee id of the additional manager in the HRIS system
    - `type` string, nullable — Type of the additional manager (e.g. capacity)
    - `email` string, nullable — Email of the additional manager
  - `customInfo` object, nullable — The custom info captured for the employee by custom fields
  - `tenureYears` number, float, nullable — The total tenure years of the employee
  - `systemId` string, nullable — The system id of the HRIS system in EF
  - `employeeCriticality` EmployeeCriticality
    - `riskOfLoss` string, nullable — The risk of looking the employee
    - `impactOfLoss` string, nullable — The impact of loss of the employee
  - `companyName` string, nullable — The company name of the employee
  - `phone` string, nullable — The phone number of the employee
  - `performanceRatings` EmployeePerformanceRating[], nullable — The performance rating of the employee
    - `periodEndDate` string, nullable — The performance period end date
    - `rating` number, float, nullable — The rating given
    - `reviewedBy` User
      - `atsUserGroups` UserGroup[], nullable — The user groups
        - `userGroupId` string, email, nullable
      - `name` string, nullable — The name of the user
      - `atsRoles` string[], nullable — The ats roles
      - `userId` string, nullable — The user id of the user
      - `firstName` string, nullable — The first name of the user
      - `lastName` string, nullable — The last name of the user
      - `email` string, email, nullable — The email of the user
    - `ratingLabel` string, nullable — The rating level
    - `reviewComments` string, nullable — The review comments
    - `periodStartDate` string, nullable — The performance period start date
    - `reviewType` string, nullable — The review type
  - `languages` EmployeeLanguageProficiency[], nullable — The employee language proficiencies
    - `read` string, nullable — The reading proficiency
    - `speak` string, nullable — The speaking proficiency
    - `overall` string, nullable — The overall proficiency
    - `language` string, nullable — The language string
    - `write` string, nullable — The writing proficiency
  - `title` string, nullable — The title of the employee
  - `id` string, nullable — The unique id of the Employee in the HRIS system
  - `terminationDate` string, nullable — The termination date of the employee
  - `hiringDate` string, nullable — The hiring date of the employee
  - `managerUserId` string, nullable — The user id of the manager in HRIS system
  - `successionPlan` EmployeeSuccessionPlan
    - `comments` string, nullable — The comments
    - `planDate` string, nullable — The date of the plan
    - `planName` string, nullable — The name of the plan
    - `successors` EmployeeSuccessor[], nullable — The successors of an employee
      - `employeeDetails` User
        - `atsUserGroups` UserGroup[], nullable — The user groups
          - `userGroupId` string, email, nullable
        - `name` string, nullable — The name of the user
        - `atsRoles` string[], nullable — The ats roles
        - `userId` string, nullable — The user id of the user
        - `firstName` string, nullable — The first name of the user
        - `lastName` string, nullable — The last name of the user
        - `email` string, email, nullable — The email of the user
      - `readiness` string, nullable — The readiness of the successor
      - `rank` integer, nullable — The rank
      - `comments` string, nullable — The comments
  - `bonus` Pay
    - `frequency` string, nullable — The frequency of pay
    - `amount` number, float, nullable — The amount of pay
    - `currency` string, nullable — The currency of pay in ISO format
  - `lastActivityTs` integer, nullable — The last activity timestamp
  - `managerFullname` string, nullable — The full name of the manager
  - `jobCode` string, nullable — The job code of the employee
  - `tenureCurrentRoleYears` number, float, nullable — The no of years the employee is in current role
  - `basePayFrequency` string, nullable — The frequency of the base pay of the employee
  - `lob` string, nullable — The lob of the employee
  - `roleChangeDate` string, nullable — The last role change date of the employee
  - `role` string, nullable — The role of the employee
  - `eligibleForTransfer` boolean, nullable — Is the employee eligible for transfer or not
  - `lastName` string, nullable — Last Name of employee

---

[API](https://skmtc.net/eightfold/apis/api-server-v2-service-service.md) · [All operations](https://skmtc.net/eightfold/apis/api-server-v2-service-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eightfold/api-server-v2-service-service/versions/0fb26f4e41bf/schema)
