Payroll

Finch’s Payroll product reads an employer’s payroll history — from company-level pay runs down to the individual line items on each employee’s pay statement. Finch classifies every line item with standard types for earnings, taxes, employee deductions, and employer contributions, so the data is consistent across providers.

​

What you can do

• Retrieve pay run history — list every payment in a date range with gross and net totals and the individuals paid.
• Read pay statement detail — inspect earnings, taxes, deductions, and contributions line by line to verify what was withheld and contributed each pay period.
• Calculate year-to-date earnings — aggregate pay statements to compute YTD wages for compliance and reporting.
• Determine pay frequency — read pay groups to know each employee’s on-cycle payment schedule.
• Standardize line items — use Finch’s pay statement item classification and custom rules to label items for your use case.

​

Payroll endpoints

To read pay statements, first call /payment for your date range, then pass the returned payment_ids to /pay-statement. See Read data for the request pattern. You can also create rules that attach custom attributes to pay statement items — for example, labeling items that meet certain conditions as a pre-tax 401(k).

​

Provider coverage

Field availability varies by provider. Check the Field Support matrix to confirm that the fields your use case requires are available from the providers your customers use.

​

Common use cases

• Retirement and 401(k) — run recordkeeping audits against standardized, historical payroll data.
• Benefits administration — confirm deductions and contributions were applied by reading pay statement line items.
• Financial planning and analysis — base headcount and cost calculations on payroll data from hundreds of providers.
• Compensation management — build compensation benchmarks from actual pay data.
• Tax credits — determine what percentage of payroll expense went to qualifying activities.

​

Next steps

Questions about whether Payroll fits your use case? Contact developers@tryfinch.com or talk to our team.