---
title: "Fetch Tax Forms In Supported Formats Based On Request Parameters."
method: POST
path: "/gw/api/v1/tax-documents"
tags: ["accountManagementReports"]
---

# Fetch Tax Forms In Supported Formats Based On Request Parameters.

`POST /gw/api/v1/tax-documents`

<br>**Scope**: `statements.write` OR `reports.write`<br>**Security Policy**: `Signed JWT`

## Headers

- `authorization` string, required

## Request body

- TaxFormRequest
  - `accountId` string, required — Account id
  - `year` string, required — Tax Year
  - `type` string, required — Tax Form Type (can retrieve available tax documents via /api/v1/tax-documents/available)
  - `format` string, required — format
  - `gzip` boolean — to gzip the whole response pass true

## Response `200`

Returns a JSON object containing the relevant Tax Form.

- TaxFormResponse
  - `data` TaxFormResponseData
    - `dataType` string — the data type of the value after decoding
    - `encoding` string — encoding used for the value
    - `value` string — Base 64 encoded String of byte[]. Byte[] represents compressed data when gzip is true
    - `mimeType` string — mimeType of document after decoding and serializing the value
    - `gzip` boolean — content encoding flag. Represents whether the response is compressed
    - `accept` string — specify response media types that are acceptable

## Other responses

- `400` — Returns a Problem detail instance representing a bad request.
- `401` — Returns a Problem detail instance representing an unauthorized request.
- `402` — Returns a Problem detail instance representing an unauthorized request.
- `403` — Returns a Problem detail instance representing a forbidden request.
- `500` — Returns a Problem detail instance representing an internal server error.

---

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