Tax Forms
List Tax Forms
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>.
get/accounts/{account_id}/tax_forms
Request
- Base URLhttps://api.getpinwheel.com/v1
- AuthAPI key in header X-API-SECRET
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
account_idstring uuid required
UUID of the payroll account.
Query parameters
from_yearinteger
Filter for tax forms during or after this year.
to_yearinteger
Filter for tax forms during or before this year.
cursorstring
Cursor for the page you want to retrieve.
limitinteger
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
Version identifier specifying how the Pinwheel API should behave. See the Change Management page for more information.
Response
OK
Changes
No recorded changes to this operation across all 13 revisions of this API.