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

---

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