---
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`

## Request

- Base URL: `https://api.usemultiplier.com`
- URL: `https://api.usemultiplier.com/v1/employees/{employeeId}/employment`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/usemultiplier/apis/multiplier-public-rest-api/docs/v1/employees/:employeeId/employment/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/usemultiplier/apis/multiplier-public-rest-api.md) - [All operations](https://skmtc.dev/usemultiplier/apis/multiplier-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usemultiplier/apis/multiplier-public-rest-api/revisions/da31bb6ec00d?raw)