---
title: "Create Tax Voucher Requests"
method: POST
path: "/gw/api/v1/tax-vouchers"
tags: ["thirdPartiesTaxVouchers"]
---

# Create Tax Voucher Requests

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

Creates tax voucher requests from a signed JWT payload. The request body must be a signed OAuth2 JWT (text/plain) whose decoded payload contains the list of tax voucher requests.<br><br>**Scope**: `tax-vouchers.write`<br>**Security Policy**: `Signed JWT`

## Headers

- `X-Request-ID` string

## Request body

- string

## Response `200`

Tax voucher requests created successfully

- TaxVoucherDTO[]
  - `requestId` string
  - `custAcctId` string
  - `corpactionId` string
  - `requestState` string
  - `fee` number, double
  - `divAmount` number, double
  - `withHeldAmount` number, double
  - `countryCode` string
  - `year` integer
  - `migratedCustAcctId` string

## Other responses

- `400` — Invalid request body
- `401` — OAuth2 JWT verification failed
- `500` — 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)