---
title: "Get Changed Employee IDs"
method: GET
path: "/api/v1/employees/changed"
tags: ["Change Tracking", "Public API"]
---

# Get Changed Employee IDs

`GET /api/v1/employees/changed`

Returns a list of employee IDs that have changed since the given timestamp. This allows for efficient syncing of employee data — rather than downloading all employees, only those that have changed are returned. A change in ANY individual field in the employee record, as well as any change to the employment status, job info, or compensation tables, will cause that employee to be returned. Each entry includes the employee ID, the type of change (Inserted, Updated, or Deleted), and the last-changed timestamp.

OAuth Scopes: public.integration, public.user

## Query parameters

- `since` string, date-time, required
- `type` 'inserted' | 'updated' | 'deleted' | 'all'

## Response `200`

The latest change timestamp in the result set and a map of employees changed since the given timestamp.

- object
  - `latest` string, date-time, required — The latest last-changed timestamp among the returned employees.
  - `employees` object, required — Map of employee IDs to change metadata for each changed employee.

## Other responses

- `400` — The since parameter is missing, is not a valid ISO 8601 date, or the type parameter is invalid.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)