Skip to content
Fresh 2026

Historic payroll

How to access historical pay rates and employment changes over time using the Merge HRIS API.


Sync Employees data following Onboard use case workflow. Make sure your user has access to the Employments model, as this holds information related to historical pay.

In your backend, pull the GET /Employees Object, as well as the related Employments Object.

To access a given Employee's current and historical employments, use the employments array on Employees.

Access historic payroll information from the Employments object:

Use the 

`effective_date`

 field to see past pay periods, and filter by time.



Use the 

`pay_rate`

 field to access the pay for a given Employment.

Please note: When there is a change in pay or title, third-party platforms that track historical data will create new Employment objects, while platforms that don't track historical data will update existing records.

Generate UI, functionality, or workflow that surfaces this information, or an analysis of this information, based on your app's functionality.

Integrate today or talk to our sales team to learn how Merge unlocks hundreds of integrations in days - not years.

Get a demo

Unofficial documentation reference. Built for internal use.