Skip to content

List Tax Countries

GET
/api/v1/tax/countries

Get tax information for all supported countries

List of countries with tax info

object
success
required
boolean
data
required
Array<object>
object
countryCode
required

ISO 3166-1 alpha-2 country code

string
>= 2 characters <= 2 characters
Example
PT
countryName
required

Country name

string
Example
Portugal
currency
required

Currency code (ISO 4217)

string
>= 3 characters <= 3 characters
Example
EUR
incomeTax
required
object
brackets
required
Array<object>
object
min
required

Minimum income for this bracket

number
0
max
required

Maximum income for this bracket (null = unlimited)

number | null
> 0
Example
50000
rate
required

Tax rate for this bracket (%)

number
<= 100
Example
20
topMarginalRate
required

Top marginal tax rate (%)

number
<= 100
Example
48
basicAllowance
required

Tax-free basic allowance

number
Example
4104
capitalGainsTax
required
object
shortTermRate
required

Short-term capital gains rate (%)

number
<= 100
Example
28
longTermRate
required

Long-term capital gains rate (%)

number
<= 100
Example
28
holdingPeriod
required

Months to qualify for long-term rate

integer
Example
12
exemptions
required

Available exemptions

Array<string>
dividendTax
required
object
domesticRate
required

Tax rate on domestic dividends (%)

number
<= 100
Example
28
foreignRate
required

Tax rate on foreign dividends (%)

number
<= 100
Example
28
withholdingRate
required

Withholding tax rate (%)

number
<= 100
Example
28
wealthTax
required
object
applicable
required

Whether wealth tax applies

boolean
rate
required

Wealth tax rate (%) if applicable

number | null
<= 10
threshold
required

Wealth threshold for tax to apply

number | null
cryptoTax
required
object
applicable
required

Whether crypto gains are taxed

boolean
rate
required

Crypto tax rate (%) if applicable

number | null
<= 100
notes
required

Additional notes on crypto taxation

string
specialPrograms
required

Available special tax programs

Array<object>
object
id
required

Program identifier

string
Example
nhr-portugal
name
required

Program name

string
Example
Non-Habitual Resident (NHR)
country
required

Country offering the program

string
Example
Portugal
description
required

Program description

string
benefits
required

Key benefits

Array<string>
Example
[
"20% flat income tax",
"0% foreign dividends",
"0% foreign pensions"
]
requirements
required

Eligibility requirements

Array<string>
duration
required

Program duration in years

integer
> 0
Example
10
flatTaxRate
required

Flat tax rate if applicable (%)

number | null
<= 100
Example
20
applicationDeadline
required

Application deadline if applicable

string | null
stillAvailable
required

Whether program is still accepting new applicants

boolean
taxTreaties
required

Countries with tax treaties

Array<string>
territorialTaxation
required

Whether territorial taxation applies

boolean
citizenshipBasedTaxation
required

Whether citizenship-based taxation applies (like US)

boolean
lastUpdated
required

Last data update timestamp

string format: date-time
meta
required
object
count
required
integer
timestamp
required
string format: date-time