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

GET /tax/tax-forms

Try it

List Tax Forms

cURL

curl --request GET \
  --url https://api.paxos.com/v2/tax/tax-forms \
  --header 'Authorization: Bearer <token>'

200

{
  "tax_form_urls": [
    {
      "account_id": "<string>",
      "type": "FORM_1099_B",
      "tax_year": "<string>",
      "revision": "<string>",
      "url": "<string>"
    }
  ]
}

OAuth Scope

tax:read_tax_form

Authorizations

Authorization · string · header · required

Paxos APIs use OAuth 2 with the client credentials grant flow.

Token URLs:

• Production: https://oauth.paxos.com/oauth2/token
• Sandbox: https://oauth.sandbox.paxos.com/oauth2/token

Learn more in the API credentials guide →

Query Parameters

account_ids · string[] · required

Required. A list of Account IDs. Maximum 50.

tax_year · string · required

Required. Tax year

form_types · enum<string>[]

Optional. Tax form types (1099-B, 1099-MISC, 1099-DA). If not provided, defaults to 1099-B for tax years prior to 2025, and 1099-DA from 2025 onwards.

Available options: FORM_1099_B, FORM_1099_MISC, FORM_1099_DA

Response

200 - application/json

A successful response.

tax_form_urls · object[]

List of tax form URLs. The size shall not exceed users_limit times form_types.

Show child attributes

tax_form_urls. account_id · string

tax_form_urls. type · enum<string>

Available options: FORM_1099_B, FORM_1099_MISC, FORM_1099_DA

tax_form_urls. tax_year · string

tax_form_urls. revision · string

tax_form_urls. url · string