---
title: "List Employees"
method: GET
path: "/hris/employees"
tags: ["hris/employees"]
---

# List Employees

`GET /hris/employees`

## Query parameters

- `remote_data` boolean
- `limit` number
- `cursor` string

## Headers

- `x-connection-token` string, required

## Response `200`

- object
  - `prev_cursor` string, nullable, required
  - `next_cursor` string, nullable, required
  - `data` object[], required
    - `groups` string[], nullable — The groups the employee belongs to
    - `locations` string[], nullable — UUIDs of the of the Location associated with the company
    - `employee_number` string, nullable — The employee number
    - `company_id` string, nullable — The UUID of the associated company
    - `first_name` string, nullable — The first name of the employee
    - `last_name` string, nullable — The last name of the employee
    - `preferred_name` string, nullable — The preferred name of the employee
    - `display_full_name` string, nullable — The full display name of the employee
    - `username` string, nullable — The username of the employee
    - `work_email` string, nullable — The work email of the employee
    - `personal_email` string, nullable — The personal email of the employee
    - `mobile_phone_number` string, nullable — The mobile phone number of the employee
    - `employments` string[], nullable — The employments of the employee
    - `ssn` string, nullable — The Social Security Number of the employee
    - `gender` string, nullable — The gender of the employee
    - `ethnicity` string, nullable — The ethnicity of the employee
    - `marital_status` string, nullable — The marital status of the employee
    - `date_of_birth` string, date-time, nullable — The date of birth of the employee
    - `start_date` string, date-time, nullable — The start date of the employee
    - `employment_status` string, nullable — The employment status of the employee
    - `termination_date` string, date-time, nullable — The termination date of the employee
    - `avatar_url` string, nullable — The URL of the employee's avatar
    - `manager_id` string, nullable — UUID of the manager (employee) of the employee
    - `field_mappings` object, nullable — The custom field mappings of the object between the remote 3rd party & Panora
    - `id` string, nullable — The UUID of the employee record
    - `remote_id` string, nullable — The remote ID of the employee in the context of the 3rd Party
    - `remote_data` object, nullable — The remote data of the employee in the context of the 3rd Party
    - `remote_created_at` string, date-time, nullable — The date when the employee was created in the 3rd party system
    - `created_at` string, date-time, nullable — The created date of the employee record
    - `modified_at` string, date-time, nullable — The last modified date of the employee record
    - `remote_was_deleted` boolean, nullable — Indicates if the employee was deleted in the remote system

## Changes

- **2024-09-05** `5ba5c769e2e1` — 1 breaking
  - for the `query` request parameter `limit`, default value `50` was added
- **2024-09-03** `8f398d57935f` — 1 breaking
  - for the `query` request parameter `limit`, default value `50` was removed
- **2024-08-27** `5ba5c769e2e1` — 21 info
  - removed the `ACTIVE` enum value from the `allOf[subschema #2]/data/items/employment_status` response property for the response status `200`
  - removed the `AMERICAN_INDIAN_OR_ALASKA_NATIVE` enum value from the `allOf[subschema #2]/data/items/ethnicity` response property for the response status `200`
  - removed the `ASIAN_OR_INDIAN_SUBCONTINENT` enum value from the `allOf[subschema #2]/data/items/ethnicity` response property for the response status `200`
  - removed the `BLACK_OR_AFRICAN_AMERICAN` enum value from the `allOf[subschema #2]/data/items/ethnicity` response property for the response status `200`
  - …17 more
- …earlier changes not shown

[Full history](https://skmtc.dev/panoratech/apis/panora-api/changes/hris/employees/get.md)

---

[API](https://skmtc.dev/panoratech/apis/panora-api.md) · [All operations](https://skmtc.dev/panoratech/apis/panora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/panoratech/apis/panora-api/revisions/634ca9b624aa?raw)