---
title: "Retrieve employee employment details"
method: GET
path: "/v1/employees/{employeeId}/employment"
tags: ["Employee Employment Details"]
---

# Retrieve employee employment details

`GET /v1/employees/{employeeId}/employment`

Get comprehensive employment information including job details,
employment status, and work history.

This endpoint provides access to the employee's current employment details
and reporting structure.

## Path parameters

- `employeeId` string, uuid, required

## Response `200`

Employee employment details retrieved successfully

- V1EmployeesEmployeeIdEmploymentGetResponse
  - `employeeCode` string, nullable — Human-readable employee code (optional)
  - `employeeId` string, nullable — Deprecated: Use employeeCode instead. Human-readable employee code (optional)
  - `workEmail` string, email, nullable — Employee's work email address
  - `entity` string, nullable — Legal entity name for the employee's employment
  - `country` string, nullable — ISO 3166-1 alpha-3 country code for the employee's country of employment
  - `startDate` string, date — Date when employee joined the company (YYYY-MM-DD)
  - `status` 'ONBOARDING' | 'ACTIVE' | 'OFFBOARDING' | 'ENDED' | 'DELETED' | 'UNKNOWN' — Current employment status
  - `endDate` string, date, nullable — Date when employee left or will leave the company (optional)
  - `designation` string — Job title or position
  - `department` string, nullable — Department name (optional)
  - `type` 'EMPLOYEE' | 'HR_MEMBER' | 'FREELANCER' | 'CONTRACTOR' | 'UNKNOWN' — Type of employment
  - `term` 'FIXED' | 'PERMANENT' | 'UNKNOWN' — Employment term (fixed-term or permanent)
  - `noticePeriod` object, nullable — Notice period details (optional).
    - `value` string — Notice period value
    - `unit` 'DAYS' | 'WEEKS' | 'MONTHS' | 'UNKNOWN' — Notice period unit
  - `exitDetails` object, nullable — Exit details for offboarded employees (optional)
    - `type` 'RESIGNATION' | 'TERMINATION' | 'DID_NOT_JOIN' | 'UNKNOWN' — Type of termination
    - `reason` string, nullable — Reason for termination (optional)
    - `dateOfTermination` string, date, nullable — Last working day for terminated employees (optional)
  - `reportsTo` object, nullable — Manager/supervisor information for this employee
    - `id` string, uuid — Unique identifier of the manager
    - `firstName` string, nullable — Manager's first name
    - `lastName` string, nullable — Manager's last name
    - `designation` string, nullable — Manager's job designation/position

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required
- `403` — Forbidden - insufficient permissions
- `404` — Resource not found
- `422` — Unprocessable entity - validation error
- `500` — Internal server error
- `503` — Service unavailable - upstream dependency error

---

[API](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api.md) · [All operations](https://skmtc.net/usemultiplier/apis/multiplier-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usemultiplier/multiplier-public-rest-api/revisions/59cd6443fdbf/schema)