---
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

## Changes

> 53 revisions in range; 3 could not be searched.

- **2025-12-18** `f81c5824a900` — 1 info
  - added the non-success response with the status `400`
- **2025-10-27** `0105d239fcaf` — 2 breaking, 1 warning, 20 info
  - the response property `oneOf[#/components/schemas/W4Document2005]/data/exemption` became nullable for the status `200`
  - the response property `oneOf[#/components/schemas/W4Document2005]/data/filing_status` became nullable for the status `200`
  - added the new `undefined` enum value to the `oneOf[#/components/schemas/W4Document2005]/data/exemption` response property for the response status `200`
  - added the new optional `query` request parameter `entity_ids`
  - …19 more
- **2025-04-22** `46640c1b4688` — 1 info
  - the endpoint scheme security `bearerAuth` was added to the API
- **2025-03-25** `69819ddc6d03` — 2 warning
  - added the new `undefined` enum value to the `oneOf[#/components/schemas/W4Document2005]/data/filing_status` response property for the response status `200`
  - added the new `undefined` enum value to the `oneOf[#/components/schemas/W4Document2020]/data/filing_status` response property for the response status `200`

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/employer/documents/:document_id/get.md)

---

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