---
title: "GET Employee by Unique ID"
method: GET
path: "/employees/unique_id/{unique_id}"
---

# GET Employee by Unique ID

`GET /employees/unique_id/{unique_id}`

/employees/unique_id/:unique_id Permission level: 5

## Path parameters

- `unique_id` string, required

## Response `2XX`

2XX

- object
  - `status` integer
  - `data` object
    - `id` string
    - `eid` string
    - `status` string
    - `deleted` string
    - `deleted_by` string
    - `legal_agree` string
    - `referral` string
    - `location` string
    - `wage` string
    - `name` string
    - `nick_name` string
    - `birth_day` string
    - `birth_month` string
    - `birth_year` unknown
    - `email` string
    - `email_confirmed` string
    - `cell_phone` string
    - `cellphone_confirmed` string
    - `address` string
    - `city` string
    - `state` string
    - `zip` string
    - `username` string
    - `realname` string
    - `timezone_id` string
    - `daily_overtime` string
    - `updated_at` string
    - `avatar` object
      - `small` string
      - `medium` string
      - `large` string
    - `avatar_url` unknown
    - `unique_id` string
    - `job_title` string
    - `gender` string
    - `language` unknown
    - `employee_type` string
    - `pay_type` string
    - `work_start_date` string
    - `home_phone` string
    - `last_visit` string
    - `registered` string
    - `smsgateway` string
    - `notes` string
    - `pref_shift_autoconfirm` string
    - `undertime` string
    - `overtime` string
    - `max_days_row` string
    - `monthly_undertime` string
    - `monthly_overtime` string
    - `pref_mtimebshifts` string
    - `middle_name` string
    - `registration_ip` string
    - `vendor_id` integer
    - `signature` unknown
    - `disp_topics` unknown
    - `disp_posts` unknown
    - `email_setting` string
    - `notify_with_post` string
    - `auto_notify` string
    - `show_smilies` string
    - `show_avatars` string
    - `show_sig` string
    - `access_keys` string
    - `dst` string
    - `time_format` string
    - `date_format` string
    - `style` string
    - `num_posts` string
    - `last_post` unknown
    - `last_search` unknown
    - `last_email_sent` unknown
    - `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
    - `last_sms_sent` string
    - `p_email` string
    - `p_phone` string
    - `notify_sms` string
    - `notify_email` string
    - `e_new_pm` string
    - `ical` string
    - `startday` string
    - `pref_caltime` string
    - `recommendation` string
    - `tut_v2_sched` string
    - `screen_logger` string
    - `sc_freq` string
    - `newsletter_receiver` string
    - `pref_sp_skin` string
    - `inline_wizard_completion` unknown
    - `title` unknown
    - `url` unknown
    - `recommend` string
    - `integration_primary_employee_position_id` unknown
    - `firstname` string
    - `lastname` string
    - `tusername` string
    - `24hr` string
    - `group` string
    - `last_active` string
    - `timezone` 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
      - `2966058` string
    - `skills` object
      - `82456` string
      - `82458` string
    - `custom` object
      - `27044` object
        - `id` string
        - `name` string
        - `type` string
        - `access` string
        - `values` string
        - `vendor_id` string
        - `value` string
        - `text` string
        - `toggle` string
      - `32708` object
        - `id` string
        - `name` string
        - `type` string
        - `access` string
        - `values` string
        - `vendor_id` string
        - `value` string
        - `text` string
        - `toggle` string
      - `32712` object
        - `id` string
        - `name` string
        - `type` string
        - `access` string
        - `values` string
        - `vendor_id` string
        - `value` string
        - `text` string
        - `toggle` string
      - `33913` object
        - `id` string
        - `name` string
        - `type` string
        - `access` string
        - `values` string
        - `vendor_id` string
        - `value` string
        - `text` string
        - `toggle` string
      - `43912` object
        - `id` string
        - `name` string
        - `type` string
        - `access` string
        - `values` string
        - `vendor_id` string
        - `value` string
        - `text` string
        - `toggle` string
      - `44987` object
        - `id` string
        - `name` string
        - `type` string
        - `access` string
        - `values` string
        - `vendor_id` string
        - `value` string
        - `text` string
        - `toggle` string
      - `44989` object
        - `id` string
        - `name` string
        - `type` string
        - `access` string
        - `values` string
        - `vendor_id` string
        - `value` string
        - `text` string
        - `toggle` string
    - `settings` object
      - `widgets_layout` array[]
        - string[]
      - `widgets_enabled` string[]
      - `schedule_side_panel_visibility` integer
      - `linked_shift_time` integer
      - `schedule_view_selected` string
      - `schedule_timeline_selected` string
      - `schedule_budget_mode_visibility` integer
      - `schedule_forecast_graph_visibility` integer
      - `forecast_demand_graph_visibility` integer
      - `schedule_copy_rules_choice` integer
      - `shift_skill_filter_visibility` integer
      - `shift_task_assignment_visibility` integer
      - `default_location_panel_visibility` integer
      - `include_ghost_shifts` integer
      - `is_first_schedule_visit` integer
      - `is_new_shift_creation_enabled` integer
      - `notifications` object
        - `channel_email` integer
        - `channel_sms` integer
        - `channel_mobile_push` integer
        - `email` object
          - `m_training_removed` integer
          - `m_training_topic_updated` integer
          - `m_homework_approved` integer
          - `m_homework_rejected` integer
          - `m_training_added` integer
          - `m_training_comment` integer
          - `m_shift_added_oncall` integer
          - `m_shift_trade_pickup_reject` integer
          - `m_removed_from_shift` integer
          - `m_added_to_shift` integer
          - `m_shift_confirmed_new` integer
          - `m_booked_removed` integer
          - `m_published` integer
          - `m_shift_removed_oncall` integer
          - `m_remind_hour` integer
          - `m_schedule_note` integer
          - `m_remind_day` integer
          - `m_shift_confirmed_old` integer
          - `m_shift_release_completed` integer
          - `m_shift_trade_completed` integer
          - `m_shift_pickup_rejected_employee` integer
          - `m_shiftswap_accepted` integer
          - `m_shiftswap_rejected` integer
          - `m_shiftswap_request` integer
          - `m_republished` integer
          - `m_shift_dropped` integer
          - `m_shiftswap_admin_reject_accepted` integer
          - `m_trade_invites` integer
          - `m_shiftswap_admin_rejected` integer
          - `m_shift_pickup_rejected` integer
          - `m_remind_clockout` integer
          - `m_remind_clockin` integer
          - `m_message_wall_post` integer
          - `m_message_wall_reply` integer
          - `m_future_availability_approved` integer
          - `m_weekly_availability_approved` integer
          - `m_future_availability_rejected` integer
          - `m_weekly_availability_rejected` integer
          - `m_birthday_card` integer
          - `new_pm` integer
          - `m_vacation_reject` integer
          - `m_vacation_accept` integer
          - `m_vacation_remove` integer
          - `m_shift_deleted` integer
          - `m_paid_break` integer
          - `m_unpaid_break` integer
          - `m_availability_rejected` integer
          - `m_availability_approved` integer
          - `m_availability_daily_summary` integer
          - `m_availability_last_minute_change` integer
          - `m_availability_absence` integer
          - `m_remind_upcoming_schedules` integer
        - `sms` object
          - `m_training_removed` integer
          - `m_training_topic_updated` integer
          - `m_homework_approved` integer
          - `m_homework_rejected` integer
          - `m_training_added` integer
          - `m_training_comment` integer
          - `m_shift_added_oncall` integer
          - `m_shift_trade_pickup_reject` integer
          - `m_removed_from_shift` integer
          - `m_added_to_shift` integer
          - `m_shift_confirmed_new` integer
          - `m_booked_removed` integer
          - `m_published` integer
          - `m_shift_removed_oncall` integer
          - `m_remind_hour` integer
          - `m_schedule_note` integer
          - `m_remind_day` integer
          - `m_shift_confirmed_old` integer
          - `m_shift_release_completed` integer
          - `m_shift_trade_completed` integer
          - `m_shift_pickup_rejected_employee` integer
          - `m_shiftswap_accepted` integer
          - `m_shiftswap_rejected` integer
          - `m_shiftswap_request` integer
          - `m_republished` integer
          - `m_shift_dropped` integer
          - `m_shiftswap_admin_reject_accepted` integer
          - `m_trade_invites` integer
          - `m_shiftswap_admin_rejected` integer
          - `m_shift_pickup_rejected` integer
          - `m_remind_clockout` integer
          - `m_remind_clockin` integer
          - `m_message_wall_post` integer
          - `m_message_wall_reply` integer
          - `m_future_availability_approved` integer
          - `m_weekly_availability_approved` integer
          - `m_future_availability_rejected` integer
          - `m_weekly_availability_rejected` integer
          - `m_birthday_card` integer
          - `new_pm` integer
          - `m_vacation_reject` integer
          - `m_vacation_accept` integer
          - `m_vacation_remove` integer
          - `m_shift_deleted` integer
          - `m_paid_break` integer
          - `m_unpaid_break` integer
          - `m_availability_rejected` integer
          - `m_availability_approved` integer
          - `m_availability_daily_summary` integer
          - `m_availability_last_minute_change` integer
          - `m_availability_absence` integer
          - `m_remind_upcoming_schedules` integer
        - `mobile_push` object
          - `m_training_removed` integer
          - `m_training_topic_updated` integer
          - `m_homework_approved` integer
          - `m_homework_rejected` integer
          - `m_training_added` integer
          - `m_training_comment` integer
          - `m_shift_added_oncall` integer
          - `m_shift_trade_pickup_reject` integer
          - `m_removed_from_shift` integer
          - `m_added_to_shift` integer
          - `m_shift_confirmed_new` integer
          - `m_booked_removed` integer
          - `m_published` integer
          - `m_shift_removed_oncall` integer
          - `m_remind_hour` integer
          - `m_schedule_note` integer
          - `m_remind_day` integer
          - `m_shift_confirmed_old` integer
          - `m_shift_release_completed` integer
          - `m_shift_trade_completed` integer
          - `m_shift_pickup_rejected_employee` integer
          - `m_shiftswap_accepted` integer
          - `m_shiftswap_rejected` integer
          - `m_shiftswap_request` integer
          - `m_republished` integer
          - `m_shift_dropped` integer
          - `m_shiftswap_admin_reject_accepted` integer
          - `m_trade_invites` integer
          - `m_shiftswap_admin_rejected` integer
          - `m_shift_pickup_rejected` integer
          - `m_remind_clockout` integer
          - `m_remind_clockin` integer
          - `m_message_wall_post` integer
          - `m_message_wall_reply` integer
          - `m_future_availability_approved` integer
          - `m_weekly_availability_approved` integer
          - `m_future_availability_rejected` integer
          - `m_weekly_availability_rejected` integer
          - `m_birthday_card` integer
          - `new_pm` integer
          - `m_vacation_reject` integer
          - `m_vacation_accept` integer
          - `m_vacation_remove` integer
          - `m_shift_deleted` integer
          - `m_paid_break` integer
          - `m_unpaid_break` integer
          - `m_availability_rejected` integer
          - `m_availability_approved` integer
          - `m_availability_daily_summary` integer
          - `m_availability_last_minute_change` integer
          - `m_availability_absence` integer
          - `m_remind_upcoming_schedules` integer
    - `permissions` object
      - `allow_wage_and_budget` boolean
    - `saved_filters` unknown
    - `integrations_metadata` object
      - `clair_status` integer
    - `aim` unknown
    - `icq` unknown
    - `jabber` unknown
    - `msn` unknown
    - `yahoo` unknown
  - `metadata` unknown[]
    - unknown
  - `token` string
  - `error` unknown

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) · [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humanity-com/humanity/revisions/6c126251f276/schema)
