---
title: "GET Employee"
method: GET
path: "/employees/{id}"
---

# GET Employee

`GET /employees/{id}`

## Request

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

/employees/:id
Permission level: 5

## Path parameters

- `id` integer, required

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` string
    - `username` string
    - `tusername` string
    - `email` string
    - `title` unknown
    - `realname` string
    - `url` unknown
    - `jabber` unknown
    - `icq` unknown
    - `msn` unknown
    - `aim` unknown
    - `yahoo` unknown
    - `location` string
    - `signature` unknown
    - `disp_topics` unknown
    - `disp_posts` unknown
    - `email_setting` string
    - `notify_with_post` string
    - `auto_notify` string
    - `show_smilies` string
    - `show_img` string
    - `show_img_sig` string
    - `show_avatars` string
    - `show_sig` string
    - `access_keys` string
    - `timezone` string
    - `dst` string
    - `time_format` string
    - `date_format` string
    - `language` unknown
    - `style` string
    - `num_posts` string
    - `last_post` unknown
    - `last_search` unknown
    - `last_email_sent` unknown
    - `registered` string
    - `registration_ip` string
    - `last_visit` string
    - `last_active` string
    - `admin_note` unknown
    - `activate_string` unknown
    - `activate_key` unknown
    - `pun_bbcode_enabled` string
    - `pun_bbcode_use_buttons` string
    - `pun_pm_new_messages` unknown
    - `pun_pm_long_subject` string
    - `newsletter` string
    - `email_confirmed` string
    - `eid` string
    - `status` string
    - `deleted` string
    - `deleted_by` string
    - `legal_agree` string
    - `referral` string
    - `wage` string
    - `name` string
    - `firstname` string
    - `lastname` string
    - `nick_name` string
    - `birth_day` string
    - `birth_month` string
    - `smsgateway` unknown
    - `cell_phone` string
    - `cellphone_confirmed` string
    - `last_sms_sent` string
    - `home_phone` string
    - `avatar` object
      - `small` string
      - `medium` string
      - `large` string
    - `address` string
    - `city` string
    - `state` string
    - `zip` string
    - `notes` string
    - `p_email` string
    - `p_phone` string
    - `notify_sms` string
    - `notify_email` string
    - `e_new_pm` string
    - `ical` string
    - `24hr` string
    - `startday` string
    - `pref_caltime` string
    - `pref_shift_autoconfirm` string
    - `undertime` string
    - `overtime` string
    - `recommend` string
    - `recommendation` string
    - `tut_v2_sched` string
    - `daily_overtime` string
    - `max_days_row` string
    - `timezone_id` unknown
    - `monthly_undertime` string
    - `monthly_overtime` string
    - `pref_mtimebshifts` string
    - `avatar_url` unknown
    - `deactivated` string
    - `work_start_date` string
    - `screen_logger` string
    - `sc_freq` string
    - `newsletter_receiver` string
    - `job_title` string
    - `middle_name` string
    - `gender` unknown
    - `pref_sp_skin` string
    - `inline_wizard_completion` unknown
    - `group` string
    - `timezone_name` string
    - `timezone_info` object
      - `timezone_id` string
      - `name` string
      - `name_formatted` string
      - `offset` string
      - `seconds` integer
      - `hours` integer
      - `default` string
      - `minutes` integer
    - `group_name` string
    - `status_name` string
    - `schedules` object
      - `1324361` string
    - `skills` object
      - `96398` string
      - `96402` string
  - `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/:id/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)
