---
title: "Get Tax Voucher Request State"
method: GET
path: "/gw/api/v1/tax-vouchers/{requestId}/state"
tags: ["thirdPartiesTaxVouchers"]
---

# Get Tax Voucher Request State

`GET /gw/api/v1/tax-vouchers/{requestId}/state`

Returns the current state of a tax voucher request by tax voucher request ID.<br><br>**Scope**: `tax-vouchers.read`<br>**Security Policy**: `HTTPS`

## Path parameters

- `requestPublicId` string, required
- `requestId` string, required

## Headers

- `X-Request-ID` string

## Response `200`

Tax voucher state returned 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

- `401` — OAuth2 verification failed
- `404` — Tax voucher request not found
- `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)