Skip to main content
Finch’s Documents product reads structured data out of employee documents stored in an employer’s HR or payroll system. Finch parses each document with ML-based extraction and returns standardized, classified fields — across multiple document formats — so you don’t have to collect the data manually.
Documents is in beta. W-4 forms are supported today, and the API is designed to expand to additional document types such as W-2 and 941 forms.

What you can do

  • List available documents — see which documents exist for an individual employee or the whole company, filtered by document type.
  • Read parsed W-4 data — retrieve filing status, dependent withholding, and additional withholding details without asking employees to re-enter them.

Documents endpoints

Documents is asynchronous: queue a job with POST /jobs/automated before reading, so Finch syncs the latest documents from the provider.

Permissions

Employers grant access to Documents alongside your other product scopes when they confirm permissions in Finch Connect. To add Documents to an existing connection, send the employer through re-authentication to approve the additional scope.

Common use cases

  • Retirement and 401(k) — enrich participant records with automatically collected W-4 data.
  • Benefits quoting — speed up quoting with filing status and dependent information straight from the W-4.
  • Financial planning and analysis — summarize additional withholdings and exemptions across the workforce.

Next steps

Documents API reference

Request and response schemas for both Documents endpoints.

Automated jobs

Queue the document sync that powers these endpoints.

Reauthentication

Add the Documents scope to existing connections.

Data syncs

How and when Finch refreshes data from providers.
Questions about whether Documents fits your use case? Contact developers@tryfinch.com or talk to our team.