{{baseUrl}}/IT-rmv
POST {{baseUrl}}/IT-rmv
The RMV endpoint allows users to query real estate properties based on various criteria. Users can search by property type, specifying whether they are looking for residential, non-residential, or pertinential properties. Additionally, users can define search parameters such as search radius, minimum and maximum price range, and the period of interest, including start and end dates. Furthermore, users can filter properties by contract type using the provided catastral codes. Searches can be conducted either by address or geographic coordinates, offering flexibility in how users locate properties.
immobili_residenziali:
The codes provided represent different categories of residential properties. These codes are used to identify and distinguish various types of properties intended for residential purposes, such as apartments, villas, cottages, and other residential dwellings.
In this category fall all the codes listed below:
A01 A02 A03 A04 A05 A06 A07 A08 A09 A11
immobili_non_residenziali:
The codes provided represent different categories of non-residential properties. These codes are used to identify and distinguish various types of properties not intended for residential purposes, such as commercial buildings, offices, warehouses, and industrial facilities.
In this category fall all the codes listed below:
A10 C01 C02 C03 C04 C06 D01 D02 D03 D05 D06 D07 D08 D10
pertinenziali:
The codes provided represent different categories of properties classified as 'pertinenziali'. These properties are closely related or connected to residential or non-residential properties and may include garages, parking spaces, and other auxiliary structures.
In this category fall all the codes listed below:
C02 C06
The mandatory fields are: - property_type - address or latitude and longitude
Request Body
{"address"=>"<string>", "property_type"=>"<string>", "latitude"=>"<string>", "longitude"=>"<string>", "search_radius"=>250, "min_amount"=>"<integer>", "max_amount"=>"<integer>", "start_year"=>"<integer>", "start_month"=>"<integer>", "end_year"=>"<integer>", "end_month"=>"<string>", "cc"=>["<string>", "<string>"]}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"data":[{"units":[{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-02-01","property_sale_year":"2023","property_sale_month":"2","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"C02","market_sector":"PER","keycode":"cd06ee2fef0b46dbbcf86569aae0586c","year":"2023","office_code":"RM10","total_property":3,"id_property":1,"price":439500,"latitude":41.8057123,"longitude":12.4385838,"address":"VIA ANTONIO SCHIVARDI, 36","property_sqm":6,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":157,"estimate_property_sqm":1.5,"surface":6},{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-02-01","property_sale_year":"2023","property_sale_month":"2","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"C06","market_sector":"PER","keycode":"cd06ee2fef0b46dbbcf86569aae0586c","year":"2023","office_code":"RM10","total_property":3,"id_property":2,"price":439500,"latitude":41.8057123,"longitude":12.4385838,"address":"VIA ANTONIO SCHIVARDI, 36","property_sqm":31,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":157,"estimate_property_sqm":15.5,"surface":31},{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-02-01","property_sale_year":"2023","property_sale_month":"2","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"A02","market_sector":"RES","keycode":"cd06ee2fef0b46dbbcf86569aae0586c","year":"2023","office_code":"RM10","total_property":3,"id_property":3,"price":439500,"latitude":41.8057123,"longitude":12.4385838,"address":"VIA ANTONIO SCHIVARDI, 36","property_sqm":140,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":157,"estimate_property_sqm":140,"surface":140}],"keycode":"cd06ee2fef0b46dbbcf86569aae0586c","price":439500,"property_type":"Residenziale singolo","property_sale_date":"2023-02-01","latitude":41.8057123,"longitude":12.4385838,"property_sqm":157,"distance_form":0.017519356902882553},{"units":[{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-10-01","property_sale_year":"2023","property_sale_month":"10","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"C02","market_sector":"PER","keycode":"f2863b325e9c4908a73099c1010ed9c8","year":"2023","office_code":"RM10","total_property":2,"id_property":1,"price":148769,"latitude":41.8057123,"longitude":12.4385838,"address":"VIA ANTONIO SCHIVARDI 000010","property_sqm":8,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":128,"estimate_property_sqm":2,"surface":8},{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-10-01","property_sale_year":"2023","property_sale_month":"10","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"A02","market_sector":"RES","keycode":"f2863b325e9c4908a73099c1010ed9c8","year":"2023","office_code":"RM10","total_property":2,"id_property":2,"price":148769,"latitude":41.8057123,"longitude":12.4385838,"address":"VIA ANTONIO SCHIVARDI 000010","property_sqm":126,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":128,"estimate_property_sqm":126,"surface":126}],"keycode":"f2863b325e9c4908a73099c1010ed9c8","price":148769,"property_type":"Residenziale singolo","property_sale_date":"2023-10-01","latitude":41.8057123,"longitude":12.4385838,"property_sqm":128,"distance_form":0.017519356902882553},{"units":[{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-05-01","property_sale_year":"2023","property_sale_month":"5","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"C06","market_sector":"PER","keycode":"de9126af2749423b819cac2b0eea8967","year":"2023","office_code":"RM10","total_property":2,"id_property":1,"price":450000,"latitude":41.8057123,"longitude":12.4385838,"address":"VIA ANTONIO SCHIVARDI 000010","property_sqm":16,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":146,"estimate_property_sqm":8,"surface":16},{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-05-01","property_sale_year":"2023","property_sale_month":"5","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"A02","market_sector":"RES","keycode":"de9126af2749423b819cac2b0eea8967","year":"2023","office_code":"RM10","total_property":2,"id_property":2,"price":450000,"latitude":41.8057123,"longitude":12.4385838,"address":"VIA ANTONIO SCHIVARDI 000010","property_sqm":138,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":146,"estimate_property_sqm":138,"surface":138}],"keycode":"de9126af2749423b819cac2b0eea8967","price":450000,"property_type":"Residenziale singolo","property_sale_date":"2023-05-01","latitude":41.8057123,"longitude":12.4385838,"property_sqm":146,"distance_form":0.017519356902882553},{"units":[{"belfior_code":"H501","town":"ROMA","property_sale_date":"2022-10-01","property_sale_year":"2022","property_sale_month":"10","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"A02","market_sector":"RES","keycode":"44dc00bdf3034f068938c9bc987a80be","year":"2022","office_code":"RM10","total_property":2,"id_property":2,"price":530000,"latitude":41.8060644,"longitude":12.4384177,"address":"VIA ANTONIO SCHIVARDI, 7","property_sqm":170,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":186,"estimate_property_sqm":170,"surface":170},{"belfior_code":"H501","town":"ROMA","property_sale_date":"2022-10-01","property_sale_year":"2022","property_sale_month":"10","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"C06","market_sector":"PER","keycode":"44dc00bdf3034f068938c9bc987a80be","year":"2022","office_code":"RM10","total_property":2,"id_property":1,"price":530000,"latitude":41.8060644,"longitude":12.4384177,"address":"VIA ANTONIO SCHIVARDI, 7","property_sqm":32,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":186,"estimate_property_sqm":16,"surface":32}],"keycode":"44dc00bdf3034f068938c9bc987a80be","price":530000,"property_type":"Residenziale singolo","property_sale_date":"2022-10-01","latitude":41.8060644,"longitude":12.4384177,"property_sqm":186,"distance_form":0.02519723025055234},{"units":[{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-01-01","property_sale_year":"2023","property_sale_month":"1","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"C06","market_sector":"PER","keycode":"105fdd509ed84c05a5395b4eef6c652b","year":"2023","office_code":"RM10","total_property":3,"id_property":1,"price":535000,"latitude":41.8056608,"longitude":12.4380928,"address":"VIA ILDEBRANDO VIVANTI, 174","property_sqm":12,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":171.5,"estimate_property_sqm":6,"surface":12},{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-01-01","property_sale_year":"2023","property_sale_month":"1","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"C06","market_sector":"PER","keycode":"105fdd509ed84c05a5395b4eef6c652b","year":"2023","office_code":"RM10","total_property":3,"id_property":2,"price":535000,"latitude":41.8056608,"longitude":12.4380928,"address":"VIA ILDEBRANDO VIVANTI, 174","property_sqm":17,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":171.5,"estimate_property_sqm":8.5,"surface":17},{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-01-01","property_sale_year":"2023","property_sale_month":"1","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"A02","market_sector":"RES","keycode":"105fdd509ed84c05a5395b4eef6c652b","year":"2023","office_code":"RM10","total_property":3,"id_property":3,"price":535000,"latitude":41.8056608,"longitude":12.4380928,"address":"VIA ILDEBRANDO VIVANTI, 174","property_sqm":157,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":171.5,"estimate_property_sqm":157,"surface":157}],"keycode":"105fdd509ed84c05a5395b4eef6c652b","price":535000,"property_type":"Residenziale singolo","property_sale_date":"2023-01-01","latitude":41.8056608,"longitude":12.4380928,"property_sqm":171.5,"distance_form":0.03637843321278157},{"units":[{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-01-01","property_sale_year":"2023","property_sale_month":"1","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"C02","market_sector":"PER","keycode":"e5401ba77592470dbd9eff40dfa7b1eb","year":"2023","office_code":"RM10","total_property":2,"id_property":1,"price":473000,"latitude":41.8065811,"longitude":12.4389099,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","property_sqm":12,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":148,"estimate_property_sqm":3,"surface":12},{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-01-01","property_sale_year":"2023","property_sale_month":"1","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"A02","market_sector":"RES","keycode":"e5401ba77592470dbd9eff40dfa7b1eb","year":"2023","office_code":"RM10","total_property":2,"id_property":2,"price":473000,"latitude":41.8065811,"longitude":12.4389099,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","property_sqm":145,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":148,"estimate_property_sqm":145,"surface":145}],"keycode":"e5401ba77592470dbd9eff40dfa7b1eb","price":473000,"property_type":"Residenziale singolo","property_sale_date":"2023-01-01","latitude":41.8065811,"longitude":12.4389099,"property_sqm":148,"distance_form":0.09045102193209242},{"units":[{"belfior_code":"H501","town":"ROMA","property_sale_date":"2022-05-01","property_sale_year":"2022","property_sale_month":"5","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"C06","market_sector":"PER","keycode":"RM102022050412","year":"2022","office_code":"RM10","total_property":2,"id_property":1,"price":170247,"latitude":41.8065811,"longitude":12.4389099,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","property_sqm":11,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":162.5,"estimate_property_sqm":5.5,"surface":11},{"belfior_code":"H501","town":"ROMA","property_sale_date":"2022-05-01","property_sale_year":"2022","property_sale_month":"5","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"A02","market_sector":"RES","keycode":"RM102022050412","year":"2022","office_code":"RM10","total_property":2,"id_property":2,"price":170247,"latitude":41.8065811,"longitude":12.4389099,"address":"VIALE BEATA VERGINE DEL CARMELO 000181","property_sqm":157,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":162.5,"estimate_property_sqm":157,"surface":157}],"keycode":"RM102022050412","price":170247,"property_type":"Residenziale singolo","property_sale_date":"2022-05-01","latitude":41.8065811,"longitude":12.4389099,"property_sqm":162.5,"distance_form":0.09045102193209242},{"units":[{"belfior_code":"H501","town":"ROMA","property_sale_date":"2022-09-01","property_sale_year":"2022","property_sale_month":"9","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"A02","market_sector":"RES","keycode":"47434eebd71a445dbe26103c975f80e9","year":"2022","office_code":"RM10","total_property":1,"id_property":1,"price":172732,"latitude":41.8065811,"longitude":12.4389099,"address":"VIALE BEATA VERGINE DEL CARMELO, 149","property_sqm":154,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":154,"estimate_property_sqm":154,"surface":154}],"keycode":"47434eebd71a445dbe26103c975f80e9","price":172732,"property_type":"Residenziale singolo","property_sale_date":"2022-09-01","latitude":41.8065811,"longitude":12.4389099,"property_sqm":154,"distance_form":0.09045102193209242},{"units":[{"belfior_code":"H501","town":"ROMA","property_sale_date":"2022-09-01","property_sale_year":"2022","property_sale_month":"9","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"A02","market_sector":"RES","keycode":"30a1db4b89d8479685ce904f399ec572","year":"2022","office_code":"RM10","total_property":1,"id_property":1,"price":385000,"latitude":41.8065811,"longitude":12.4389099,"address":"VIALE BEATA VERGINE DEL CARMELO, 149","property_sqm":155,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":155,"estimate_property_sqm":155,"surface":155}],"keycode":"30a1db4b89d8479685ce904f399ec572","price":385000,"property_type":"Residenziale singolo","property_sale_date":"2022-09-01","latitude":41.8065811,"longitude":12.4389099,"property_sqm":155,"distance_form":0.09045102193209242},{"units":[{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-06-01","property_sale_year":"2023","property_sale_month":"6","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"A02","market_sector":"RES","keycode":"3d03e256828048b58ce75197def2fb03","year":"2023","office_code":"RM10","total_property":2,"id_property":2,"price":480000,"latitude":41.8050856,"longitude":12.4391081,"address":"VIA ANTONIO SCHIVARDI 000045","property_sqm":171,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":187,"estimate_property_sqm":171,"surface":171},{"belfior_code":"H501","town":"ROMA","property_sale_date":"2023-06-01","property_sale_year":"2023","property_sale_month":"6","property_type":"Residenziale","omi_zone":"D82","property_type_detail":"Residenziale singolo","type":"Residenziale","category_cat":"C06","market_sector":"PER","keycode":"3d03e256828048b58ce75197def2fb03","year":"2023","office_code":"RM10","total_property":2,"id_property":1,"price":480000,"latitude":41.8050856,"longitude":12.4391081,"address":"VIA ANTONIO SCHIVARDI 000045","property_sqm":32,"region":"Lazio","province":"RM","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","property_sqm_total":187,"estimate_property_sqm":16,"surface":32}],"keycode":"3d03e256828048b58ce75197def2fb03","price":480000,"property_type":"Residenziale singolo","property_sale_date":"2023-06-01","latitude":41.8050856,"longitude":12.4391081,"property_sqm":187,"distance_form":0.09961142405776394}],"success":true,"message":"","error":null}