---
title: "List Tax Forms"
method: GET
path: "/tax/tax-forms"
tags: ["Tax Forms"]
---

# List Tax Forms

`GET /tax/tax-forms`

Used for bulk file transfer use cases.
List tax forms for given account ids and tax year. The most recent revision number will be returned (revisions increment up; highest value revision for a specific account, tax year, and form type pairing is the most recent).
Tax Form URL links will expire after 60 seconds.
Please call ListTaxFormRevisions endpoint for all versions of a single accounts tax forms.
Supported form types: 1099-B, 1099-MISC, and 1099-DA. If form_types is not provided, defaults to 1099-B for tax years prior to 2025, and 1099-DA from 2025 onwards.

## Query parameters

- `account_ids` string[], required
- `tax_year` string, required
- `form_types` string[]

## Response `200`

A successful response.

- ListTaxFormsResponse
  - `tax_form_urls` TaxFormURL[] — List of tax form URLs. The size shall not exceed `users_limit` times `form_types`.
    - `account_id` string
    - `type` 'FORM_1099_B' | 'FORM_1099_MISC' | 'FORM_1099_DA'
    - `tax_year` string
    - `revision` string
    - `url` string

---

[API](https://skmtc.net/paxos/apis/paxos-api.md) · [All operations](https://skmtc.net/paxos/apis/paxos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paxos/paxos-api/revisions/0687ca8c9a8d/schema)