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

- `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 — The current start index of the returned list of elements
  - `documents` object[], required
    - `id` string, uuid — A stable Finch id for the document.
    - `individual_id` string, nullable — The ID of the individual associated with the document. This will be null for employer-level documents.
    - `url` string, uri — A URL to access the document. Format: `https://api.tryfinch.com/employer/documents/:document_id`.
    - `year` number, nullable — The year the document applies to, if available.
    - `type` 'w4_2020' | 'w4_2005' — The type of document.

---

[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/14d375aab89e/schema)