---
title: "GET Employees"
method: GET
path: "/employees"
---

# GET Employees

`GET /employees`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/employees`
- Auth: API key in query parameter `access_token`

/employees
Permission level: 7

## Query parameters

- `schedule` integer
- `location` integer
- `disabled` integer
- `inactive` integer
- `with_custom_fields` integer
- `scheduler_users` integer
- `check_permission` integer
- `fields[employee]` 'id' | 'avatar' | 'legacy_avatar' | 'avatar_url' | 'name' | 'p_phone' | 'p_email' | 'cell_phone' | 'home_phone' | 'email' | 'group_name' | 'status_name' | 'vendor_id' | 'schedules' | 'skills' | 'registered' | 'last_active' | 'birth_day' | 'birth_month' | 'birth_year' | 'work_start_date' | 'location' | 'state' | 'city' | 'zip' | 'nick_name' | 'username' | 'address' | 'include_skill_data'

## Response `200`

200

- object
  - `status` integer
  - `data` object[]
    - `id` string
    - `language` unknown
    - `work_start_date` string
    - `eid` string
    - `name` string
    - `firstname` string
    - `lastname` string
    - `username` string
    - `email` string
    - `group` string
    - `status` string
    - `wage` string
    - `nick_name` string
    - `birth_day` string
    - `birth_month` string
    - `cell_phone` string
    - `home_phone` string
    - `avatar` object
      - `small` string
      - `medium` string
      - `large` string
    - `avatar_url` unknown
    - `address` string
    - `city` string
    - `state` string
    - `zip` string
    - `notes` string
    - `ical` string
    - `registered` string
    - `last_active` string
    - `p_phone` string
    - `p_email` string
    - `location` string
    - `timezone` string
    - `schedules` object
      - `1321634` string
    - `skills` object
      - `96398` string
      - `96403` string
      - `96404` string
    - `timezone_name` string
    - `group_name` string
    - `status_name` string
    - `custom` unknown[]
      - unknown
  - `token` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/employees/get.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
