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.