flatin.pt — Portuguese property taxes

What buying a home in Portugal costs on top of the price: IMT (property transfer tax), Imposto do Selo (stamp duty) and the published price of the property registration. Official 2026 tables, including the reduced IMT table and the stamp duty deduction for buyers aged 35 or under. Both taxes are charged on the higher of the contract price and the VPT: pass `vpt` when it is known. Returns amounts in cents and formatted in euros, with the source of the tables.

{
  "type": "object",
  "properties": {
    "value": {
      "type": "string",
      "description": "Purchase price as written in the contract, in euros, e.g. 250000 or 250000.50"
    },
    "territory": {
      "type": "string",
      "enum": [
        "continente",
        "regioes_autonomas"
      ],
      "description": "Mainland Portugal (continente) or the Azores and Madeira (regioes_autonomas). Default: continente"
    },
    "primary_home": {
      "type": "boolean",
      "description": "The buyer's own permanent home (habitação própria e permanente). Default: true"
    },
    "buyer_is_young": {
      "type": "boolean",
      "description": "The buyer is 35 or under on the date of the deed, is buying their first own permanent home, is not an IRS dependant and has owned no residential property in the previous three years. Applies the reduced IMT table and the stamp duty deduction (art. 7.º-A Código do Imposto do Selo; not applied above the second band of the young buyers' table). Only applies when primary_home is true. Default: false"
    },
    "vpt": {
      "type": "string",
      "description": "Optional. The VPT (valor patrimonial tributário) from the caderneta predial, in euros. IMT and stamp duty are charged on the higher of the price and the VPT (CIMT art. 12.º n.º 1), so pass it when it is known"
    }
  },
  "required": [
    "value"
  ]
}

The yearly property tax (IMI) rate in one Portuguese municipality, by name or four-digit code. Collected from the Autoridade Tributária portal and checked line by line for all 308 municipalities. Where a municipality sets no single rate (it is set per parish), the answer says so instead of returning zero.

{
  "type": "object",
  "properties": {
    "municipality": {
      "type": "string",
      "description": "Municipality name in Portuguese (Porto, Lisboa, Vila Nova de Gaia) or its four-digit code (1312)"
    }
  },
  "required": [
    "municipality"
  ]
}

Yearly IMI for an urban property (prédio urbano) with a given taxable value (VPT) in one municipality, at the municipality's urban rate. VPT is the tax authority's valuation, not the purchase price: ask the user for it instead of using the price.

{
  "type": "object",
  "properties": {
    "municipality": {
      "type": "string",
      "description": "Municipality name in Portuguese (Porto, Lisboa, Vila Nova de Gaia) or its four-digit code (1312)"
    },
    "vpt": {
      "type": "string",
      "description": "Valor Patrimonial Tributário — the taxable value of the property in euros. Not the purchase price"
    }
  },
  "required": [
    "municipality",
    "vpt"
  ]
}

How to put the user in touch with a licensed real estate agency in Portugal: returns the form link and the GDPR (RGPD) consent text in the user's language. The request is submitted by the person, not on their behalf.

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "description": "The user's language: pt, en, ru, ua, de, fr, nl (uk is accepted too). Default: en"
    }
  }
}