---
title: "List Documents"
method: GET
path: "/employer/documents"
tags: ["Documents"]
---

# List Documents

`GET /employer/documents`

**Beta:** This endpoint is in beta and may change.
Retrieve a list of company-wide documents.

## Query parameters

- `entity_ids` string[]
- `limit` integer
- `offset` integer
- `individual_ids` string[]
- `types` string[]

## Headers

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

## Response `200`

OK

- ListDocumentsResponse
  - `paging` Paging, required
    - `count` integer — The total number of elements for the entire query (not just the given page)
    - `offset` integer, required — The current start index of the returned list of elements
  - `documents` DocumentItem[], required
    - `id` string, uuid, required — A stable Finch id for the document.
    - `individual_id` string, nullable, required — The ID of the individual associated with the document. This will be null for employer-level documents.
    - `url` string, uri, required — A URL to access the document. Format: `https://api.tryfinch.com/employer/documents/:document_id`.
    - `year` number, required — The year the document applies to, if available.
    - `type` 'w4_2020' | 'w4_2005', required — The type of document.

## Other responses

- `400` — Bad Request

## Changes

- **2025-12-18** `f81c5824a900` — 1 info
  - added the non-success response with the status `400`
- **2025-10-27** `0105d239fcaf` — 6 info
  - added the new optional `query` request parameter `entity_ids`
  - the response property `documents/items/id` became required for the status `200`
  - the response property `documents/items/individual_id` became required for the status `200`
  - the response property `documents/items/type` became required for the status `200`
  - …2 more
- **2025-05-08** `f09e5f2c555d` — 1 info
  - the response property `paging/offset` became required for the status `200`
- **2025-04-22** `46640c1b4688` — 1 info
  - the endpoint scheme security `bearerAuth` was added to the API

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/employer/documents/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)