Raw schema
{
"type": "object",
"properties": {
"q": {
"description": "Only comuni whose name contains this (case- and accent-insensitive).",
"type": "string",
"minLength": 2,
"maxLength": 80
},
"region": {
"description": "A region name or slug, e.g. \"Abruzzo\" or \"valle-d-aosta\".",
"type": "string",
"minLength": 2,
"maxLength": 60
},
"province": {
"description": "A province's two-letter code (\"AQ\") or slug (\"l-aquila\").",
"type": "string",
"minLength": 2,
"maxLength": 60
},
"minPopulation": {
"description": "Residents, inclusive.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"maxPopulation": {
"description": "Residents, inclusive.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"minPurchasePriceEurM2": {
"description": "Purchase price in EUR/m2, inclusive. A comune with no price is left out, never treated as cheap.",
"type": "number",
"minimum": 0
},
"maxPurchasePriceEurM2": {
"description": "Purchase price in EUR/m2, inclusive. A comune with no price is left out, never treated as cheap.",
"type": "number",
"minimum": 0
},
"minRentEurM2Month": {
"description": "Rent in EUR/m2 per month, inclusive. A comune with no rent figure is left out.",
"type": "number",
"minimum": 0
},
"maxRentEurM2Month": {
"description": "Rent in EUR/m2 per month, inclusive. A comune with no rent figure is left out.",
"type": "number",
"minimum": 0
},
"minPopulationChangePct": {
"description": "Population change 2019 to 2025, in percent, inclusive. A negative value means decline.",
"type": "number"
},
"maxPopulationChangePct": {
"description": "Population change 2019 to 2025, in percent, inclusive.",
"type": "number"
},
"minJanuaryLowC": {
"description": "[UI key jan] Average January daily minimum (ERA5-Land, 2015 to 2024) at least this many degrees C, whole numbers -10 to 12. Town grain. A comune with no figure is left out and counted in missingData.",
"type": "integer",
"minimum": -10,
"maximum": 12
},
"maxDaysAbove30C": {
"description": "[UI key heat] Average days a year above 30 C (ERA5-Land, 2015 to 2024) at most this many, 0 to 120. Town grain. No figure: left out and counted.",
"type": "integer",
"minimum": 0,
"maximum": 120
},
"minHospitalCareScore": {
"description": "[UI key hosp] Ministero della Salute NSG 2024 hospital-care score at least this, 50 to 100; 60 is the official sufficiency line. REGION grain: every comune in a region shares its region's score, except Bolzano-province and Trento-province comuni, which carry their own autonomous province's score. No figure: left out and counted.",
"type": "integer",
"minimum": 50,
"maximum": 100
},
"allCareScoresAtLeast60": {
"description": "[UI key nsg60] true: the NSG prevention, community-care and hospital-care scores must all be at least 60. Region grain (autonomous-province grain for Bolzano and Trento). A comune missing any of the three is left out and counted.",
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"enum": [
"true",
"false"
]
}
]
},
"maxBedsPerResident": {
"description": "[UI key beds] Registered tourist beds per resident (ISTAT, 2024) at most this; one of 0.1, 0.5, 1. Town grain. A comune with no figure is left out and counted; a real zero is a figure.",
"type": "number"
},
"excludeSeismicZone1": {
"description": "[UI key seis] true: leave out comuni in official seismic zone 1, the highest hazard class (hazard class 4 in the map layer). A legal classification from the Dipartimento della Protezione Civile (31 May 2025), not a forecast. A comune with no single classification is left out and counted.",
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"enum": [
"true",
"false"
]
}
]
},
"maxHospitalDriveMinutes": {
"description": "[UI key hdrive] Minutes by road from the comune's main town to the nearest hospital with inpatient beds (Ministero della Salute 2023 list, OpenStreetMap roads) at most this; one of 15, 30, 45, 60. Town grain, free-flow, approximate. Not necessarily a hospital with an emergency department. A comune with no figure (for example a ferry-only island) is left out and counted.",
"type": "number"
},
"maxEmergencyDriveMinutes": {
"description": "[UI key edrive] Minutes by road from the comune's main town to the nearest emergency department in the Ministero della Salute's emergency network (sites active at 31 December 2025: DEA level II, DEA level I or Pronto Soccorso; OpenStreetMap roads) at most this; one of 15, 30, 45, 60. Town grain, free-flow, approximate; not a service guarantee. Combine with emergencyDeaOnly to count only DEA level I or II. A comune with no figure is left out and counted.",
"type": "number"
},
"emergencyDeaOnly": {
"description": "[UI key edlevel=dea] With maxEmergencyDriveMinutes: count only a DEA (level I or II), not a Pronto Soccorso. A DEA is a larger emergency department with more specialties on site. Ignored without maxEmergencyDriveMinutes.",
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"enum": [
"true",
"false"
]
}
]
},
"maxAirportDriveMinutes": {
"description": "[UI key adrive] Minutes by road from the comune's main town to the nearest of the airports where ENAC recorded at least 4,000 passengers in 2025 (it leaves out Taranto-Grottaglie and Brescia-Montichiari, which carried almost none), at most this; one of 60, 90, 120, 180. Town grain, free-flow, approximate; says nothing about flights. No figure: left out and counted.",
"type": "number"
},
"taxRegime": {
"description": "A verified geographic regime slug from /tax/regimes. Lists only comuni on the regime's verified routes; a comune missing from the list is NOT a \"no\" (the rule may admit comuni by routes not yet encoded).",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"sort": {
"default": "population",
"description": "Sort key. A comune without a figure for the sort key always sorts last.",
"type": "string",
"enum": [
"population",
"name",
"purchasePrice",
"rent",
"populationChange",
"januaryLow",
"daysAbove30C",
"hospitalCareScore",
"bedsPerResident",
"seismicClass",
"hospitalDriveMinutes",
"emergencyDriveMinutes",
"deaDriveMinutes",
"airportDriveMinutes",
"supermarketDriveMinutes",
"pharmacyDriveMinutes",
"stationDriveMinutes"
]
},
"order": {
"description": "Default: desc for population, populationChange, januaryLow and hospitalCareScore; asc for name, purchasePrice, rent, daysAbove30C, bedsPerResident, seismicClass, hospitalDriveMinutes, emergencyDriveMinutes, deaDriveMinutes, airportDriveMinutes, supermarketDriveMinutes, pharmacyDriveMinutes and stationDriveMinutes.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"limit": {
"default": 25,
"description": "Rows per page, 1–100. Default 25.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"default": 0,
"description": "Rows to skip, for the next page.",
"type": "integer",
"minimum": 0,
"maximum": 10000
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}