---
title: "List Tax Forms"
method: GET
path: "/accounts/{account_id}/tax_forms"
tags: ["Tax Forms"]
---

# List Tax Forms

`GET /accounts/{account_id}/tax_forms`

## Request

- Base URL: `https://api.getpinwheel.com/v1`
- URL: `https://api.getpinwheel.com/v1/accounts/{account_id}/tax_forms`
- Auth: API key in header `X-API-SECRET`
- TypeScript: <https://skmtc.dev/getpinwheel/apis/pinwheel/docs/accounts/:account_id/tax_forms/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all tax forms associated with a payroll account. Each tax form contains metadata like year, form type, and form ID. Tax forms are returned in reverse chronological order by year. This is a paginated endpoint; see how Pinwheel implements pagination <a href='https://docs.pinwheelapi.com/docs/pagination-1' target='_blank'>here</a>.

## Path parameters

- `account_id` string, uuid, required: UUID of the payroll account.

## Query parameters

- `from_year` integer: Filter for tax forms during or after this year.
- `to_year` integer: Filter for tax forms during or before this year.
- `cursor` string: Cursor for the page you want to retrieve.
- `limit` integer: The maximum number of results to return.

## Headers

- `Pinwheel-Version` '2025-07-08' | '2023-11-22' | '2023-07-18' | '2023-04-18' | '2022-09-09' | '2022-06-22' | '2022-03-02', required

## Response `200`

OK

- object
  - `meta` RefreshablePaginationListMeta, required
    - `refreshed_at` string, date-time: ISO 8601 timestamp of the most recent refresh of this data.
    - `count` integer: Number of objects returned.
    - `next_cursor` string: Pointer to the next page of results.
  - `data` TaxFormObjResponseNoDocumentV20220622[], required
    - `id` string, uuid, required: Unique identifier for the object.
    - `created_at` string, date-time, required: ISO 8601 timestamp of created time.
    - `account_id` string, uuid, required: UUID of the payroll account.
    - `form_type` 'W-2' | 'W-2C' | '1099-NEC' | '1099-MISC' | '1099-K' | '1040', required: The type of form.
    - `year` integer, required: The tax year of the form.

---

[API](https://skmtc.dev/getpinwheel/apis/pinwheel.md) - [All operations](https://skmtc.dev/getpinwheel/apis/pinwheel/llms.txt) - [OpenAPI document](https://skmtc.dev/getpinwheel/apis/pinwheel/revisions/4543563d0f72?raw)