---
title: "Get Document"
method: GET
path: "/employer/documents/{document_id}"
tags: ["Documents"]
---

# Get Document

`GET /employer/documents/{document_id}`

**Beta:** This endpoint is in beta and may change.
Retrieve details of a specific document by its ID.

## Path parameters

- `document_id` string, required

## Query parameters

- `entity_ids` string[]

## Headers

- `Finch-API-Version` string, date, required

## Response `200`

Successful response with document data specific to form type.

- union
  - W4Document2020 — A 2020 version of the W-4 tax form containing information on an individual's filing status, dependents, and withholding details.
    - `type` 'w4_2020', required — Specifies the form type, indicating that this document is a 2020 W4 form.
    - `year` number, required — The tax year this W4 document applies to.
    - `data` object, required — Detailed information specific to the 2020 W4 form.
      - `individual_id` string, uuid, required — The unique identifier for the individual associated with this document.
      - `filing_status` 'head_of_household' | 'married_filing_jointly_or_qualifying_surviving_spouse' | 'single_or_married_filing_separately' | 'null', nullable, required — The individual's filing status for tax purposes.
      - `amount_for_qualifying_children_under_17` integer, required — Amount claimed for dependents under 17 years old (in cents).
      - `total_claim_dependent_and_other_credits` integer, required — Total amount claimed for dependents and other credits (in cents).
      - `amount_for_other_dependents` integer, required — Amount claimed for dependents other than qualifying children under 17 (in cents).
      - `other_income` integer, required — Additional income from sources outside of primary employment (in cents).
      - `deductions` integer, required — Deductible expenses (in cents).
      - `extra_withholding` integer, required — Additional withholding amount (in cents).
  - W4Document2005 — A 2005 version of the W-4 tax form containing information on an individual's filing status, dependents, and withholding details.
    - `type` 'w4_2005', required — Specifies the form type, indicating that this document is a 2005 W4 form.
    - `year` number, required — The tax year this W4 document applies to.
    - `data` object, required — Detailed information specific to the 2005 W4 form.
      - `individual_id` string, uuid, required — The unique identifier for the individual associated with this 2005 W4 form.
      - `filing_status` 'married' | 'married_but_withhold_at_higher_single_rate' | 'single' | 'null', nullable, required — The individual's filing status for tax purposes.
      - `total_number_of_allowances` integer, required — Total number of allowances claimed (in cents).
      - `additional_withholding` integer, required — Additional withholding amount (in cents).
      - `exemption` 'exempt' | 'non_exempt' | 'null', nullable, required — Indicates exemption status from federal tax withholding.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/finch-api/apis/api-reference.md) · [All operations](https://skmtc.net/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/f1cca2cb0ef2/schema)
