API, MCP en open data
Dezelfde cijfers als op de site, machineleesbaar: IMT en zegelrecht bij aankoop, IMI-tarieven van alle 308 gemeenten. Zonder sleutel en zonder registratie.
Bijgewerkt op
HTTP-API
JSON over HTTPS, zonder authenticatie. Het OpenAPI-schema staat onderaan de lijst; dat is wat gereedschap leest.
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
Voor assistenten die tools aanroepen. Transport Streamable HTTP, zonder sessies: stuur JSON-RPC via POST naar het adres hieronder. Een GET antwoordt met 405 — er is hier geen SSE-stroom, en de specificatie staat dat toe.
https://flatin.pt/mcp
Tools van de server
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.
Ondersteunde protocolrevisies: 2025-06-18, 2025-11-25
Open data
De IMI-tarieven van alle gemeenten in één bestand onder de CC BY 4.0-licentie. De datasetpagina vertelt wat erin zit en wanneer het is gecontroleerd.
Drie regels
De cijfers in de API zijn de cijfers op de site. Een tweede bron van dezelfde cijfers zou de eerste ooit tegenspreken.
Elk antwoord bevat een attribution-veld: wie het berekende, uit welke tabel en welk jaar, met link. Laat het aan uw lezer zien — een cijfer zonder bron is niet te controleren.
De frequentie is begrensd: 120 verzoeken per minuut per adres op REST en 60 op MCP. De weigering komt als 429 en zegt na hoeveel seconden je terug mag. De hele set komt als één bestand — hem gemeente voor gemeente doorlopen hoeft niet.
Status van de dienst, wijzigingslog en machineleesbare beschrijvingen (in het Engels): Status · Changelog · Rate limits · APIs.json · llms.txt