---
title: "Fetch Dividend Details"
method: GET
path: "/gw/api/v1/tax-vouchers/dividends"
tags: ["thirdPartiesTaxVouchers"]
---

# Fetch Dividend Details

`GET /gw/api/v1/tax-vouchers/dividends`

Retrieves dividend details for the given customer account, year, and country.<br><br>**Scope**: `tax-vouchers.read`<br>**Security Policy**: `HTTPS`

## Query parameters

- `custAcctId` string, required
- `year` string, required
- `countryCode` string, required

## Headers

- `X-Request-ID` string

## Response `200`

List of dividends returned successfully

- DividendDTO[]
  - `currency` string
  - `exDate` string
  - `payDate` string
  - `corpactionId` string
  - `country` string
  - `isin` string
  - `securityDesc` string
  - `symbol` string
  - `voucher` 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 parameters
- `401` — OAuth2 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)