CountryTaxCalc Data API

Server and database status check.

curl https://api.countrytaxcalc.com/api/v1/health

{
  "status": "healthy",
  "timestamp": "2026-07-06T12:00:00.000Z",
  "database": "connected"
}

All 111+ supported countries with currency metadata. API key is accepted but not required — this endpoint is publicly accessible.

curl https://api.countrytaxcalc.com/api/v1/countries

Country metadata — currency, calculation complexity, available jurisdiction codes.

curl https://api.countrytaxcalc.com/api/v1/countries/DE \
  -H "X-API-Key: ctc_your_key"

Raw tax bracket data — no income required. Cached 1 hour. Add ?year=2024 for historical data (Growth+).

curl https://api.countrytaxcalc.com/api/v1/countries/DE/rates \
  -H "X-API-Key: ctc_your_key"

{
  "country_code": "DE",
  "country_name": "Germany",
  "currency": "EUR",
  "tax_year": 2026,
  "calculation_type": "progressive",
  "source_url": "https://www.bundesfinanzministerium.de/",
  "last_updated": "2026-04-15",
  "brackets": [
    { "from": 0, "to": 11784, "rate": 0, "rate_percent": "0.0%" },
    { "from": 11784, "to": 66761, "rate": 0.14, "rate_percent": "14.0%" },
    { "from": 66761, "to": null, "rate": 0.42, "rate_percent": "42.0%" }
  ],
  "deductions": [...],
  "social_contributions": [...]
}

Full tax calculation with income tax, social contributions, deductions, and take-home pay. Auto-converts currency if input differs from the country's local currency.

curl -X POST https://api.countrytaxcalc.com/api/v1/calculate \
  -H "X-API-Key: ctc_your_key" \
  -H "Content-Type: application/json" \
  -d '{"country": "DE", "income": 80000, "currency": "USD"}'

import requests

response = requests.post(
    "https://api.countrytaxcalc.com/api/v1/calculate",
    headers={"X-API-Key": "ctc_your_key"},
    json={"country": "DE", "income": 80000, "currency": "USD"}
)
data = response.json()
print(data["totals"]["net_income"])  # take-home pay

const response = await fetch("https://api.countrytaxcalc.com/api/v1/calculate", {
  method: "POST",
  headers: {
    "X-API-Key": "ctc_your_key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ country: "DE", income: 80000, currency: "USD" })
});
const data = await response.json();
console.log(data.totals.net_income); // take-home pay

$response = file_get_contents(
    "https://api.countrytaxcalc.com/api/v1/calculate",
    false,
    stream_context_create(["http" => [
        "method"  => "POST",
        "header"  => "X-API-Key: ctc_your_key\r\nContent-Type: application/json\r\n",
        "content" => json_encode(["country" => "DE", "income" => 80000, "currency" => "USD"])
    ]])
);
$data = json_decode($response, true);
echo $data["totals"]["net_income"]; // take-home pay

{
  "country": "Germany",
  "country_code": "DE",
  "tax_year": 2026,
  "currency": "EUR",
  "gross_income": 73872,
  "currency_conversion": {
    "input_income": 80000,
    "input_currency": "USD",
    "local_currency": "EUR",
    "exchange_rate": 0.9234,
    "converted_income": 73872,
    "fx_source": "frankfurter",
    "fx_rate_age_hours": 18.4
  },
  "breakdown": {
    "taxable_income": 62268,
    "national_income_tax": {
      "amount": 19843,
      "effective_rate": 26.86,
      "marginal_rate": 42
    },
    "social_contributions": [...],
    "special_taxes": [...]
  },
  "totals": {
    "total_tax": 25634,
    "net_income": 48238,
    "effective_tax_rate": 34.7,
    "take_home_percentage": 65.3,
    "monthly_net_income": 4019.8
  },
  "metadata": {
    "accuracy_confidence": 0.95,
    "data_source": "Bundeszentralamt für Steuern",
    "last_updated": "2026-04-15"
  }
}

All 111+ countries ranked by effective tax rate for a given income level.

curl "https://api.countrytaxcalc.com/api/v1/summary?income=100000" \
  -H "X-API-Key: ctc_your_key"

{
  "income": 100000,
  "currency_note": "Income treated as nominal in each country's local currency.",
  "tax_year": 2026,
  "total_countries": 111,
  "countries": [
    {
      "rank": 1,
      "country_code": "AE",
      "country_name": "United Arab Emirates",
      "total_tax": 0,
      "net_income": 100000,
      "effective_tax_rate": 0,
      "effective_tax_rate_percent": "0.0%"
    }
  ]
}

Compare tax across up to 20 countries in a single request. All monetary values are in each country's local currency. Allow 2–5 seconds for large requests.

curl -X POST https://api.countrytaxcalc.com/api/v1/compare \
  -H "X-API-Key: ctc_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "income": 100000,
    "currency": "USD",
    "countries": [
      { "country": "US", "jurisdiction": "CA" },
      { "country": "GB" },
      { "country": "DE" },
      { "country": "SG" }
    ]
  }'