Initial Data Syncs
After an employer connects through Finch Connect, Finch automatically initiates an initial sync to retrieve available data across supported endpoints. Effective June 11, 2025 Finch will fetch the following for Pay data:- 2 full years of historical data
- Year-to-date for the current calendar year
Provider limitations
Some providers restrict how much historical data is available.- Paychex Flex: up to 14 months of pay statement data
- Paycom: up to 2 years of pay statement data
Ongoing data syncs
After the initial sync, Finch keeps data fresh by syncing on the following schedule: Finch API responses always return the most recent successful sync. Most requests complete in under 200 milliseconds.Verify data freshness
Finch includes response headers that indicate the freshness of the data:Response Header | Description |
---|---|
Finch-Data-Retrieved | The date/time that the data was retrieved from the employment system. |
Finch-Last-Attempted-Update-Date | The date/time that Finch last attempted to sync the data for this endpoint. |
Batch sync behavior
For batch endpoints like/employment
, /individual
, and /pay-statement
, Finch syncs all records in a single operation. This ensures that all data returned in the response reflects the same point in time.