---
title: "List employee's employment history."
method: GET
path: "/people/{id}/employment"
tags: ["Employee Tables"]
---

# List employee's employment history.

`GET /people/{id}/employment`

Returns a list of employment history entries for a given employee.

Each employment entry includes the working pattern assigned to this employee. To learn more about working patterns, see [How to work with Working patterns](https://apidocs.hibob.com/docs/how-to-work-with-working-patterns).

**Required permissions**

*   For all the employment table entries: **People's Data > Employment > View selected employees' Employment section histories**.

*   For the current effective employment entry only: **People's Data > Employment > View selected employees' Employment sections**.
*   For the employees: **People's Data > Access data for**: Make sure the employees are in the list. Employees that are not listed and were specifically requested will be listed under \`errors\` in the response.

## Path parameters

- `id` string, required

## Query parameters

- `includeArchived` boolean

## Response `200`

List of employment history entries.

- EmploymentEntries
  - `values` EmploymentEntry[]
    - `id` integer — ID.
    - `reason` string — The reason for this change.
    - `effectiveDate` string, date, required — The date this entry becomes effective.
    - `personalWorkingPatternType` string — indicates whether the working pattern personal (adjusted). Can be null (no personal defined), "custom", "library" or "flexible".
    - `actualWorkingPattern` union
      - WorkingPatternHourly
        - `workingPatternType` string
        - `days` object
          - `sunday` number
          - `monday` number
          - `tuesday` number
          - `wednesday` number
          - `thursday` number
          - `friday` number
          - `saturday` number
        - `hoursPerDay` number
        - `workingPatternId` number
      - WorkingPatternBiWeekly
        - `workingPatternType` string
        - `firstWeek` object
          - `sunday` number
          - `monday` number
          - `tuesday` number
          - `wednesday` number
          - `thursday` number
          - `friday` number
          - `saturday` number
        - `secondWeek` object
          - `sunday` number
          - `monday` number
          - `tuesday` number
          - `wednesday` number
          - `thursday` number
          - `friday` number
          - `saturday` number
        - `hoursPerDay` number
        - `workingPatternId` number
      - WorkingPatternFlexible
        - `workingPatternType` string
        - `weeklyWorkPercentage` number
    - `standardWorkingPattern` object — The working pattern that was selected from the library as standard. If null this means the standard is using the site default.
    - `standardWorkingPatternId` number — The working pattern ID that was selected from the library as standard.
    - `workingPattern` object — The personalized (adjusted) working pattern.
    - `siteWorkingPattern` WorkingPatternHourly
      - `workingPatternType` string
      - `days` object
        - `sunday` number
        - `monday` number
        - `tuesday` number
        - `wednesday` number
        - `thursday` number
        - `friday` number
        - `saturday` number
      - `hoursPerDay` number
      - `workingPatternId` number
    - `hoursInDayNotWorked` number — Based on the actual working pattern
    - `weeklyHours` number — Based on the actual working pattern
    - `fte` number — the FTE percentage for this entry as calculated based on the working pattern
    - `calendarName` string — The selected Holiday calendar
    - `calendarId` integer — The selected Holiday calendar
    - `contract` string — Contract, can be Full-Time, Part-Time, Shifts
    - `type` string — Type as appears in the Employment Type list. Can be Permanent, Temporary, Apprentice, Contractor or any custom value.
    - `salaryPayType` string — Salary pay type, can be Salaries or Hourly.
    - `endEffectiveDate` string, date — For entries that are not active - this is the date this entry became not effective.
    - `activeEffectiveDate` string, date — The effective date of the active working pattern.
    - `isCurrent` boolean — Is 'true' when this is the effective entry which is currently active.
    - `canBeDeleted` boolean
    - `modificationDate` string, date — The date this entry was modified.
    - `CreationDate` string, date — The date this entry was created.
    - `flsaCode` string — FLSA code, can be Exempt or Non-Exempt.
    - `change` object — Details of the last change and the ID of the user who updated this entry
      - `reason` string
      - `changedBy` string
      - `changedById` string
  - `restricted_columns` RestrictedColumnsMetadata — Indicates which columns were filtered from the response due to field-level permissions (FLP). This object is only present when FLP is enabled for the company and the service user has partial column permissions. To learn more, see <a href="https://apidocs.hibob.com/docs/employee-data-api-field-level-permissions#detecting-restricted-columns-in-api-responses" target="_blank">Field level permissions</a>.
    - `no_view_permission` string[] — Columns filtered because the service user lacks View permission for these fields.
    - `no_view_history_permission` string[] — Columns filtered because the service user lacks View History permission. Only present for historical tables (work, employment, salaries, lifecycle).

---

[API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/revisions/0781ebbdda91/schema)