Skip to main content
GET
/
employer
/
documents
/
{document_id}
JavaScript
import Finch from '@tryfinch/finch-api';

const client = new Finch({
  accessToken: 'My Access Token',
});

const response = await client.hris.documents.retreive('document_id');

console.log(response);
{
  "type": "w4_2005",
  "year": 2005,
  "data": {
    "individual_id": "f92b3db4-7bcb-4a54-a570-396bf99e041a",
    "filing_status": "married",
    "total_number_of_allowances": 22000,
    "additional_withholding": 10000,
    "exemption": "exempt"
  }
}

Authorizations

​
Authorization
string
header
required

Please use your Access Token

Headers

​
Finch-API-Version
string<date>
default:2020-09-17
required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Path Parameters

​
document_id
string
required

The unique identifier of the document.

Query Parameters

​
entity_ids
string<uuid>[]

The entity IDs to specify which entities' data to access.

Required array length: 1 element
Example:
["550e8400-e29b-41d4-a716-446655440000"]

Response

200 - application/json

Successful response with document data specific to form type.

A 2020 version of the W-4 tax form containing information on an individual's filing status, dependents, and withholding details.

​
type
enum<string>
required

Specifies the form type, indicating that this document is a 2020 W4 form.

Available options:
w4_2020
​
year
number
required

The tax year this W4 document applies to.

​
data
object
required

Detailed information specific to the 2020 W4 form.