Skip to content
IndepAI API Docs

List Tax Countries

GET
/api/v1/tax/countries
curl --request GET \
  --url https://indepai.app/api/v1/tax/countries

Get tax information for all supported countries

Responses

Section titled “Responses”

200

Section titled “200”

List of countries with tax info

Media typeapplication/json
object
success
required
boolean
data
required
Array<object>
object
countryCode
required

ISO 3166-1 alpha-2 country code

string
>= 2 characters <= 2 characters
countryName
required

Country name

string
currency
required

Currency code (ISO 4217)

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

Minimum income for this bracket

number
max
required

Maximum income for this bracket (null = unlimited)

number | null
> 0
rate
required

Tax rate for this bracket (%)

number
<= 100
topMarginalRate
required

Top marginal tax rate (%)

number
<= 100
basicAllowance
required

Tax-free basic allowance

number
capitalGainsTax
required
object
shortTermRate
required

Short-term capital gains rate (%)

number
<= 100
longTermRate
required

Long-term capital gains rate (%)

number
<= 100
holdingPeriod
required

Months to qualify for long-term rate

integer
exemptions
required

Available exemptions

Array<string>
dividendTax
required
object
domesticRate
required

Tax rate on domestic dividends (%)

number
<= 100
foreignRate
required

Tax rate on foreign dividends (%)

number
<= 100
withholdingRate
required

Withholding tax rate (%)

number
<= 100
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
name
required

Program name

string
country
required

Country offering the program

string
description
required

Program description

string
benefits
required

Key benefits

Array<string>
requirements
required

Eligibility requirements

Array<string>
duration
required

Program duration in years

integer
> 0
flatTaxRate
required

Flat tax rate if applicable (%)

number | null
<= 100
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
Example
{
  "success": true,
  "data": [
    {
      "countryCode": "PT",
      "countryName": "Portugal",
      "currency": "EUR",
      "incomeTax": {
        "brackets": [
          {
            "min": 0,
            "max": 50000,
            "rate": 20
          }
        ],
        "topMarginalRate": 48,
        "basicAllowance": 4104
      },
      "capitalGainsTax": {
        "shortTermRate": 28,
        "longTermRate": 28,
        "holdingPeriod": 12
      },
      "dividendTax": {
        "domesticRate": 28,
        "foreignRate": 28,
        "withholdingRate": 28
      },
      "specialPrograms": [
        {
          "id": "nhr-portugal",
          "name": "Non-Habitual Resident (NHR)",
          "country": "Portugal",
          "benefits": [
            "20% flat income tax",
            "0% foreign dividends",
            "0% foreign pensions"
          ],
          "duration": 10,
          "flatTaxRate": 20
        }
      ]
    }
  ]
}