---
title: "Retrieve Employee"
method: GET
path: "/hris/employees/{id}"
tags: ["hris/employees"]
---

# Retrieve Employee

`GET /hris/employees/{id}`

Retrieve an Employee from any connected Hris software

## Path parameters

- `id` string, required

## Query parameters

- `remote_data` boolean

## Headers

- `x-connection-token` string, required

## Response `200`

- UnifiedHrisEmployeeOutput
  - `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-08-27** `5ba5c769e2e1` — 21 info
  - removed the `ACTIVE` enum value from the `employment_status` response property for the response status `200`
  - removed the `AMERICAN_INDIAN_OR_ALASKA_NATIVE` enum value from the `ethnicity` response property for the response status `200`
  - removed the `ASIAN_OR_INDIAN_SUBCONTINENT` enum value from the `ethnicity` response property for the response status `200`
  - removed the `BLACK_OR_AFRICAN_AMERICAN` enum value from the `ethnicity` response property for the response status `200`
  - …17 more
- **2024-08-13** `d5ae27a39da8` — 21 warning, 2 info
  - added the new `ACTIVE` enum value to the `employment_status` response property for the response status `200`
  - added the new `AMERICAN_INDIAN_OR_ALASKA_NATIVE` enum value to the `ethnicity` response property for the response status `200`
  - added the new `ASIAN_OR_INDIAN_SUBCONTINENT` enum value to the `ethnicity` response property for the response status `200`
  - added the new `BLACK_OR_AFRICAN_AMERICAN` enum value to the `ethnicity` response property for the response status `200`
  - …19 more
- …earlier changes not shown

[Full history](https://skmtc.dev/panoratech/apis/panora-api/changes/hris/employees/:id/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)