API, MCP und offene Daten
Dieselben Zahlen wie auf der Website, maschinenlesbar: IMT und Stempelsteuer beim Kauf, IMI-Sätze aller 308 Gemeinden. Ohne Schlüssel, ohne Anmeldung.
Aktualisiert am
HTTP-API
JSON über HTTPS, ohne Authentifizierung. Das OpenAPI-Schema steht am Ende der Liste; es ist das, was Werkzeuge lesen.
GET |
/api/v1/barometer/official.csv |
The official INE series the barometer is checked against |
GET |
/api/v1/barometer/sce.csv |
ADENE energy-certificate statistics (SCE) for new housing |
GET |
/api/v1/barometer/series |
The same barometer series as JSON, with attribution |
GET |
/api/v1/barometer/series.csv |
Building-permit barometer: monthly case counts per municipality |
GET |
/api/v1/imi/rates |
IMI rates for all municipalities |
GET |
/api/v1/imi/rates-history.csv |
Every verified year of IMI rates in one CSV file |
GET |
/api/v1/imi/rates.csv |
The same rates as one CSV file |
GET |
/api/v1/imi/rates.geojson |
IMI rates with municipality boundaries (GeoJSON) |
GET |
/api/v1/imi/rates/{codigo} |
IMI rate of one municipality |
POST |
/api/v1/imt/calculate |
What a purchase costs on top of the price |
GET |
/api/openapi.json |
OpenAPI 3.1 |
MCP-Server
Für Assistenten, die Werkzeuge aufrufen. Transport Streamable HTTP, ohne Sitzungen: JSON-RPC per POST an die Adresse unten. Ein GET antwortet mit 405 — einen SSE-Stream gibt es hier nicht, und die Spezifikation erlaubt das.
https://flatin.pt/mcp
Werkzeuge des Servers
imt_calculate- 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.
imi_rate- 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.
imi_annual_cost- 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.
request_consultation- 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.
Unterstützte Protokollrevisionen: 2025-06-18, 2025-11-25
Offene Daten
Die IMI-Sätze aller Gemeinden in einer Datei unter der Lizenz CC BY 4.0. Die Datensatzseite sagt, was darin steht und wann zuletzt geprüft wurde.
Drei Regeln
Die Zahlen der API sind die Zahlen der Website. Eine zweite Quelle derselben Zahlen würde der ersten irgendwann widersprechen.
Jede Antwort trägt ein attribution-Feld: wer gerechnet hat, nach welcher Tabelle und welchem Jahr, mit Link. Zeigen Sie es Ihren Lesern — eine Zahl ohne Quelle lässt sich nicht prüfen.
Die Frequenz ist begrenzt: 120 Anfragen pro Minute je Adresse im REST und 60 im MCP. Die Ablehnung kommt als 429 und nennt die Wartezeit in Sekunden. Der ganze Datensatz kommt als eine Datei — Gemeinde für Gemeinde durchzugehen ist nicht nötig.
Dienststatus, Änderungsprotokoll und maschinenlesbare Beschreibungen (auf Englisch): Status · Changelog · Rate limits · APIs.json · llms.txt