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

# List employees

`GET /hris/employees`

## Request

- Base URL: `https://unify.apideck.com`
- URL: `https://unify.apideck.com/hris/employees`
- Auth: API key in header `Authorization`

Returns a paginated list of employees from the connected HR platform.

## Query parameters

- `cursor` string, nullable
- `limit` integer

## Headers

- `x-apideck-consumer-id` string, required
- `x-apideck-app-id` string, required
- `x-apideck-service-id` string

## Response `200`

Employees returned

- EmployeesResponse
  - `status_code` integer
  - `status` string
  - `data` Employee[]
    - `id` string
    - `first_name` string
    - `last_name` string
    - `employee_number` string
    - `department` object
    - `employment_status` string
    - `updated_at` string, date-time
  - `meta` Meta: Cursor-based pagination metadata.
    - `items_on_page` integer
    - `cursors` object
      - `previous` string, nullable
      - `current` string, nullable
      - `next` string, nullable

## Other responses

- `400`: Request validation failed.
- `401`: Missing or invalid API key.
- `404`: The requested resource, connection, or connector could not be found.

---

[API](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api.md) · [All operations](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api/revisions/1814558af2d7?raw)