---
title: "Get a tax form"
method: POST
path: "/getTaxForm"
tags: ["Account holders"]
---

# Get a tax form

`POST /getTaxForm`

Generates a tax form for account holders operating in the US. For more information, refer to [Providing tax forms](https://docs.adyen.com/classic-platforms/tax-forms).

## Request body

- GetTaxFormRequest
  - `accountHolderCode` string, required — The account holder code you provided when you created the account holder.
  - `formType` string, required — Type of the requested tax form. For example, 1099-K.
  - `year` integer, required — Applicable tax year in the YYYY format.

## Response `200`

OK - the request has succeeded.

- GetTaxFormResponse
  - `content` string, byte — The content of the tax form in the Base64 binary format.
  - `contentType` string — The content type of the tax form.
  - `pspReference` string — The reference of a request. Can be used to uniquely identify the request.
  - `resultCode` string — The result code.
  - `submittedAsync` boolean — Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied: * **true**: The request is queued and will be executed when the providing service is available in the order in which the requests are received. * **false**: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

> 28 revisions in range; 1 could not be searched.

- **2023-03-22** (v3) `a6068822877c` — 7 breaking
  - the request's body type/format changed from ``/`` to `object`/``
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - the response's body type/format changed from ``/`` to `object`/`` for status `400`
  - the response's body type/format changed from ``/`` to `object`/`` for status `401`
  - …3 more
- **2021-08-07** (v3) `9ca745af6f06` — 1 info
  - api tag `Account holders` added
- **2021-07-09** (v3) `178852251c31` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BasicAuth` was added to the API
- **2021-04-10** (v3) `ceb412cd780b` — 5 info
  - added the optional property `status` to the response with the `400` status
  - added the optional property `status` to the response with the `401` status
  - added the optional property `status` to the response with the `403` status
  - added the optional property `status` to the response with the `422` status
  - …1 more
- **2021-03-05** (v3) `b04b573249e2` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/adyen/apis/accountservice/changes/getTaxForm/post.md)

---

[API](https://skmtc.dev/adyen/apis/accountservice.md) · [All operations](https://skmtc.dev/adyen/apis/accountservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/accountservice/revisions/5896dea74c98/schema)