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_2020",
  "year": 2020,
  "data": {
    "individual_id": "f92b3db4-7bcb-4a54-a570-396bf99e041a",
    "filing_status": "single",
    "amount_for_qualifying_children_under_17": 2000,
    "amount_for_other_dependents": 1000,
    "other_income": 500,
    "deductions": 300,
    "extra_withholding": 100
  }
}

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.

Pattern: ([12]\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01]))

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

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.