---
title: "List of employee field histories"
method: GET
path: "/employees/{employee_id}/field_histories"
tags: ["Employees"]
---

# List of employee field histories

`GET /employees/{employee_id}/field_histories`

## Request

- Base URL: `https://app.peopleforce.io/api/public/v3`
- URL: `https://app.peopleforce.io/api/public/v3/employees/{employee_id}/field_histories`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/peopleforce/apis/company-api/docs/employees/:employee_id/field_histories/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the history of an employees historical field

## Query parameters

- `employee_field_internal_name` string
- `internal_names[]` string

## Response `200`

OK

- object
  - `data` EmployeeFieldHistory[]
    - `effective_on` string, date
    - `value` string
  - `metadata` Pagination
    - `page` integer
    - `pages` integer
    - `count` integer
    - `items` integer

---

[API](https://skmtc.dev/peopleforce/apis/company-api.md) - [All operations](https://skmtc.dev/peopleforce/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peopleforce/apis/company-api/revisions/ff612e61a4c3?raw)