Dividend tax withheld abroad
withholding_checkComputes, on the dividends the user gives (a year of dividends, gross, by payer: a ticker such as "NESN.SW" or a country code), the tax each payer's country keeps at source, the treaty rate, and what was withheld above it over 12 months, which only that country refunds on a claim; for a French resident, also the treaty part France credits on form 2047. Same engine as Portfolio Terminal's Income and Pro tabs: statutory rates as of 2026, a US dividend at 15% (W-8BEN on file), European-listed funds paying no withholding. Countries outside its table are named, never guessed. Nothing is stored. Use it for "how much Swiss tax do I lose on Nestlé dividends", "which of my dividends are over-withheld".
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"residence": "<residence>",
"dividends": "<dividends>"
},
"name": "withholding_check"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| currency | No | Currency of every amount (default EUR for FR, USD otherwise). | |
| dividends | Yes | One line per payer: a year of dividends, gross (before any tax). At most 100. | |
| residence | Yes | Where the user pays tax: FR (France), US, or other (the usual 15% treaty rate is used). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| asOf | Yes | ||
| rows | Yes | ||
| rule | Yes | ||
| gross | Yes | ||
| credit | Yes | ||
| excess | Yes | ||
| currency | Yes | ||
| withheld | Yes | ||
| notAdvice | Yes | ||
| residence | Yes | ||
| uncovered | Yes | ||
| notTaxedAbroad | Yes |