---
title: "Returns specific employee"
method: GET
path: "/employees/{employeeId}"
tags: ["Employees"]
---

# Returns specific employee

`GET /employees/{employeeId}`

## Path parameters

- `employeeId` integer, required

## Response `200`

Employee

- object
  - `data` Employee — Available relations: assignments, unarchived_assignments, archived_assignments, documentations, absences, notes, absence_account_times, time_account_balances, absence_account_balances, balance_compensations, target_working_times, current_target_working_time, earliest_target_working_time, timesheets, timesheet_activities, caused_changelog_entries, logins, planner_notifications, notification_logs, logs, calendars, unread_logins, group, picture, settings, upload, devices, license, changelog
    - `id` integer — ID
    - `first_line` string — First line
    - `custom_number` string — Custom number
    - `picture_id` integer — Photo
    - `group_id` integer — Team
    - `first_name` string — First name
    - `last_name` string — Last name
    - `full_name` string — Full name
    - `email` string — Email
    - `password_changed_at` string, date-time — Last password change
    - `phone` string — Landline
    - `mobile` string — Mobile
    - `street` string — Street and no.
    - `zip` string — ZIP code
    - `city` string — City
    - `province` string — State/Province
    - `country` string — Country
    - `lat` number — Latitude
    - `lng` number — Longitude
    - `number` string — Initials / No.
    - `position` string — Job title
    - `department` string — Department
    - `skills` string — Skills
    - `holidays_per_year` number, float — Holiday entitlement this year
    - `holidays_overtake_balances` boolean — Carry over last year's holidays
    - `driver_license` boolean — Driver's license
    - `truck_license` boolean — Truck driver's license
    - `inactive` boolean — Inactive
    - `initials` string — Initials / No.
    - `picture_is_avatar` boolean — Picture is avatar
    - `icon` string — Icon
    - `color` string — Color
    - `contrast_color` 'dark' | 'white' — Contrast color
    - `locale` 'de_DE' | 'en_US' | 'pl_PL' | 'uk_UA' | 'ro_RO' | 'es_ES' — Display language
    - `timezone` string — Timezone
    - `info` string — Additional info
    - `source` string — The source of the employee data
    - `source_external_id` string, nullable — The external ID from the source
    - `created_at` string, date-time — Created
    - `updated_at` string, date-time — Updated

## Other responses

- `401` — The request lacks valid authentication credentials.
- `403` — The token is valid but lacks the permission for this action.
- `404` — The requested resource could not be found.
- `500` — An unexpected error occurred on the server (e.g. a requested relation does not exist).

---

[API](https://skmtc.net/craftboxx/apis/craftboxx-api-documentation.md) · [All operations](https://skmtc.net/craftboxx/apis/craftboxx-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/craftboxx/craftboxx-api-documentation/versions/c01f07a02f77/schema)