{"openapi":"3.0.0","info":{"description":"The API provides endpoints for accessing real estate data, including comparable property data, property valuation, and market trends. Users can query the API using various criteria such as property type, location, and contract type to retrieve relevant data.\n\nSome requests are processed asynchronously. In these cases, the API immediately returns a request ID that can be used to retrieve the final result through dedicated GET endpoints.\n\nOptionally, a callback system can be configured to receive automatic notifications when the request is completed. This allows clients to avoid polling and handle results more efficiently.\n\nOverall, the API simplifies access to real estate data, making it easy for developers to integrate property information into their applications.\n\n\n**IN SANDBOX**\n\nIn the sandbox environment, consistent test data will be returned for API requests. This ensures predictability and facilitates testing and development processes. Users can rely on the sandbox environment to receive the same predefined data for various scenarios, allowing them to validate their application's functionality reliably without impacting live data or systems.\n","version":"2.0.0","title":"Realestate","termsOfService":"https://openapi.it/en/terms-and-conditions","contact":{"url":"https://openapi.it/en/support","name":"Support"},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}},"servers":[{"url":"https://realestate.openapi.com","description":"Production"},{"url":"https://test.realestate.openapi.com","description":"Sandbox"}],"tags":[{"name":"Real Market Value","description":"The IT-rm_value  Retrieve real market value data for properties.\n"},{"name":"Square Meter Value","description":"The IT-sqm  Retrieve square meter data for properties.\n"},{"name":"Real Estate Market Data","description":"Search individual property listings (for sale or for rent) near a geographic point and retrieve the monthly average price-per-square-metre history (sale or rent) for a municipality."},{"name":"OMI Zones","description":"The IT-omi endpoint. Retrieve the official OMI (Osservatorio del Mercato Immobiliare) zone and valuation range data for a geographic point."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"ApiEnvelope":{"type":"object","description":"Common response envelope shared by every endpoint of this API. The `data` property is defined per-endpoint.","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful."},"message":{"type":"string","description":"A message related to the request."},"error":{"type":"number","nullable":true,"description":"Error code if any, otherwise null."}}},"ErrorResponse":{"type":"object","description":"Standard error response body returned whenever `success` is false (validation errors, not-found, payment errors, etc.). `data` is always null.","properties":{"success":{"type":"boolean","enum":[false],"example":false},"message":{"type":"string","description":"Human-readable description of the error."},"error":{"type":"number","description":"Numeric error code identifying the specific validation/error condition."},"data":{"nullable":true,"enum":[null],"example":null,"description":"Always null for error responses."}}},"sqm_value_start":{"type":"object","properties":{"nome":{"type":"string","description":"Name of the location or address of the property"},"citta":{"type":"string","description":"Name of the city"},"cod_cat":{"type":"string","description":"Category code of the property (Codice Belfiore del comune)"},"provincia":{"type":"string","description":"Province of the property"},"regione":{"type":"string","description":"Name of the region"},"fascia":{"type":"string","description":"OMI zone classification (e.g., centrale, semicentrale, periferica)"},"address":{"type":"string","description":"Complete address of the property"},"formatted":{"type":"string","description":"Formatted address of the property"},"loc2011":{"type":"string","description":"Localization identifier"},"coordinate":{"type":"object","description":"Geographic coordinates of the property","properties":{"lat":{"type":"number","format":"float","description":"Latitude of the property"},"lng":{"type":"number","format":"float","description":"Longitude of the property"}}},"immobile":{"type":"object","properties":{"type":{"type":"string","description":"Type of property"},"label":{"type":"string","description":"Label of the property type"},"id":{"type":"integer","description":"Identifier of the property type"}}},"quotazione":{"type":"object","properties":{"min":{"type":"number","format":"float","description":"Minimum value of the quotation"},"max":{"type":"number","format":"float","description":"Maximum value of the quotation"},"med":{"type":"number","format":"float","description":"Average value of the quotation"},"type":{"type":"string","description":"Type of contract for the quotation"},"anno":{"type":"integer","description":"Year of the quotation"},"semestre":{"type":"integer","description":"Semester of the quotation"}}},"id":{"type":"string","description":"Unique request identifier."}}},"request_pending":{"type":"object","description":"Response returned when the request is still being processed.","properties":{"id":{"type":"string","description":"Unique request identifier."},"stato":{"type":"string","description":"Current request status.","example":"in_erogazione"}}},"list_item":{"type":"object","properties":{"id":{"type":"string","description":"Unique request identifier."},"created_at":{"type":"string","format":"date-time","description":"Request creation timestamp."},"owner":{"type":"string","description":"Owner of the request."},"callback":{"oneOf":[{"$ref":"#/components/schemas/CallbackOptions"},{"type":"boolean","enum":[false]}]},"stato":{"type":"string","description":"Current request status (e.g., evasa, in_erogazione)."},"esito":{"type":"string","description":"Outcome of the request (e.g. OK, wrong address, null)."},"params":{"type":"object","description":"Parameters used to create the request."}}},"rm_value_completed":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the request."},"created_at":{"type":"string","format":"date-time","description":"Timestamp indicating when the request was created."},"owner":{"type":"string","description":"Identifier of the user who submitted the request."},"stato":{"type":"string","description":"Request processing status."},"params":{"type":"object","description":"Parameters used to create the request."},"esito":{"type":"string","description":"Final outcome of the request."},"sales":{"type":"array","description":"List of comparable property transactions returned for the request.","items":{"$ref":"#/components/schemas/rm_sale"}}}},"CallbackOptions":{"type":"object","description":"This is our standardized OpenAPI callback system. It enables the configuration of parameters for receiving notifications about status updates of asynchronous requests to this endpoint.","properties":{"method":{"type":"string","description":"Specify the callback method. When set to 'POST', a standard HTTP POST request will be initiated with the Content-Type header set to application/x-www-form-urlencoded. The JSON data will be encoded into a key-value pair named data (customizable using the field parameter) within the request body. If the method is set to 'JSON', a direct HTTP POST request will be made with the Content-Type header set to application/json. The raw JSON data will be directly inserted into the request body without any encoding.","enum":["POST","JSON"],"default":"JSON"},"field":{"type":"string","description":"This parameter works in conjunction with the 'method' parameter set to 'POST'. When provided as a string, it determines the name of the parameter that will be sent in the POST request.","example":"data","default":"data"},"url":{"type":"string","format":"uri","description":"A valid URL capable of handling POST requests must be entered into this parameter. For endpoints requiring authentication, the 'headers' parameter can be used to specify 'basic auth' or 'bearer auth'. The maximum timeout is 30 seconds. If 'retry' is set, the system will retry up to 'retry' times until a 200 status code is received.","example":"https://www.mysite.com/myEndpoint"},"retry":{"type":"integer","description":"The maximum number of attempts is defined by the 'retry' parameter. If the maximum number of attempts is reached without a successful status code (e.g., 200 OK), the request is considered a final failure. A time interval is often introduced between attempts to avoid overloading the server. This interval may increase exponentially with each attempt to reduce the impact on an overloaded server. The 'retry' parameter is configured to retry the request only in case of specific status codes, typically those indicating temporary errors (e.g., 502, 503) or network issues.","example":3,"maximum":5,"minimum":0,"default":0},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"A collection of HTTP headers to be sent with the request. Each header is defined as a key-value pair. Headers can be used for various purposes, including authentication, content negotiation, and custom metadata.","example":{"session_id":"9834r5fh589494"}},"custom":{"type":"object","description":"This object can be populated with any additional data you wish to include in the callback response. This data will be accessible within the 'custom' parameter of the callback function. You can use this to store and retrieve any relevant information that you need for your application.","example":{"my_custom_id":"123456789"}}},"required":["url"]},"Callback200":{"description":"Successful callback."},"Callback400":{"description":"Invalid input."},"rm_sale":{"type":"object","properties":{"keycode":{"type":"string","description":"Unique identifier of the transaction."},"price":{"type":"number","description":"Total transaction price in euros (gross value of the sale)."},"property_type":{"type":"string","description":"Type of transaction grouping (e.g., single unit, multiple units, mixed)."},"sale_date":{"type":"string","format":"date","description":"Date when the transaction was registered."},"location":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude coordinate of the property."},"lng":{"type":"number","description":"Longitude coordinate of the property."}},"description":"Geographic coordinates of the property."},"total_sqm":{"type":"number","description":"Total commercial surface of the transaction (sum of effective surfaces)."},"distance":{"type":"number","description":"Distance from the input reference point in kilometers."},"properties":{"type":"array","description":"List of cadastral units composing the transaction.","items":{"type":"object","properties":{"category_code":{"type":"string","description":"Cadastral category code (e.g., A02, C06)."},"property_category":{"type":"string","description":"General classification of the property."},"sqm":{"type":"number","description":"Declared surface of the unit in square meters."},"effective_sqm":{"type":"number","description":"Commercial surface weighted for valuation purposes (may differ from declared sqm)."},"address":{"type":"string","description":"Address of the unit."},"details":{"type":"object","properties":{"cadastral_code":{"type":"string","description":"Municipality cadastral code (Belfiore code)."},"omi_zone":{"type":"string","description":"OMI zone identifier."},"market_sector":{"type":"string","description":"Market sector classification (e.g., RES = residential, PER = pertinenziale, TCO = commercial)."},"office_code":{"type":"string","description":"Registry office code."},"sale_year":{"type":"string","description":"Year of the transaction."},"sale_month":{"type":"string","description":"Month of the transaction."},"region":{"type":"string","description":"Region of the property."},"province":{"type":"string","description":"Province of the property."},"city":{"type":"string","description":"City of the property."},"area":{"type":"string","description":"Specific area or district."},"total_properties":{"type":"number","description":"Total number of units in the transaction."},"surface_sqm":{"type":"number","description":"Surface of the specific unit."}}}}}}}},"sqm_value_advanced":{"type":"object","properties":{"nome":{"type":"string","description":"Name of the location or address of the property"},"citta":{"type":"string","description":"Name of the city"},"cod_cat":{"type":"string","description":"Category code of the property (Codice Belfiore del comune)"},"provincia":{"type":"string","description":"Province of the property"},"regione":{"type":"string","description":"Name of the region"},"fascia":{"type":"string","description":"Location range of the property"},"address":{"type":"string","description":"Complete address of the property"},"formatted":{"type":"string","description":"Formatted address of the property"},"loc2011":{"type":"string","description":"Localization identifier"},"coordinate":{"type":"object","description":"Geographic coordinates of the property","properties":{"lat":{"type":"number","format":"float","description":"Latitude of the property"},"lng":{"type":"number","format":"float","description":"Longitude of the property"}}},"immobile":{"type":"object","properties":{"type":{"type":"string","description":"Type of property"},"label":{"type":"string","description":"Label of the property type"},"id":{"type":"integer","description":"Identifier of the property type"}}},"quotazione":{"type":"object","properties":{"min":{"type":"number","format":"float","description":"Minimum value of the quotation"},"max":{"type":"number","format":"float","description":"Maximum value of the quotation"},"med":{"type":"number","format":"float","description":"Average value of the quotation"},"type":{"type":"string","description":"Type of contract for the quotation"}}},"ripartizione_annunci":{"type":"object","properties":{"vendita":{"type":"object","description":"Distribution of advertisements for sales","additionalProperties":{"type":"object","properties":{"tipologia":{"type":"string","description":"Type of property advertised for sale"},"percentuale":{"type":"number","format":"float","description":"Percentage of advertisements for this property type"}}}},"affitto":{"type":"object","description":"Distribution of advertisements for rentals","additionalProperties":{"type":"object","properties":{"tipologia":{"type":"string","description":"Type of property advertised for rent"},"percentuale":{"type":"number","format":"float","description":"Percentage of advertisements for this property type"}}}}}},"dimensioni":{"type":"array","description":"Distribution of property sizes","items":{"type":"object","properties":{"label":{"type":"string","description":"Size range label"},"percentuale":{"type":"number","format":"float","description":"Percentage of properties within this size range"}}}},"capoluoghi_vendite_zona":{"type":"object","description":"Sales statistics for the area","additionalProperties":{"oneOf":[{"type":"object","properties":{"num_abitazioni_zona":{"type":"string"},"numero_abitazioni_vendute":{"type":"string"},"perc_variazione_annuale":{"type":"string"},"dinamicita_mercato_residenziale":{"type":"string"}}},{"type":"array","items":{}}]}},"demografico":{"type":"object","description":"Demographic data for the area","properties":{"pop":{"type":"object","description":"Population statistics","properties":{"media_componenti_famiglia":{"type":"string"},"dimensione_nuclei_familiari":{"type":"string"},"livello_anzianita":{"type":"string"},"livello_istruzione":{"type":"string"},"livello_disoccupazione":{"type":"string"}}},"stock":{"type":"object","description":"Housing stock statistics","properties":{"abitanti_per_edificio":{"type":"string"},"abitazioni_per_edificio":{"type":"string"},"prc_edifici_produttivi_commerciali":{"type":"string"},"prc_edifici_residenziali":{"type":"string"},"mq_abitazione_media":{"type":"string"},"prc_abitazioni_di_proprieta":{"type":"string"},"prc_abitazioni_vuote_o_2_case":{"type":"string"}}},"geo":{"type":"object","description":"Geographic data","properties":{"id":{"type":"string"},"loc2011":{"type":"string"},"id_provincia":{"type":"string"},"cod_cat":{"type":"string"},"tipo_localita":{"type":"string"},"nome_localita":{"type":"string"},"altitudine":{"type":"string"}}},"rischio_sismico":{"type":"string","description":"Seismic risk"},"capoluogo":{"type":"array","items":{"type":"object","properties":{"media_num_abitazioni_zona":{"type":"string"},"media_numero_abitazioni_vendute":{"type":"string"},"dinamicita_mercato_residenziale":{"type":"string"}}}}}},"tempistiche":{"type":"array","description":"Grouped timing data by category","items":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Size range label"},"media_giorni":{"type":"integer","description":"Average days to complete transaction"}}}}},"id":{"type":"string","description":"Unique request identifier."}}},"RealestateLocation":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude in decimal degrees."},"lng":{"type":"number","description":"Longitude in decimal degrees."}}},"RealestateListing":{"type":"object","description":"A single listing as returned by GET /IT-comparable.","properties":{"type":{"type":"string","enum":["sale","rent"],"description":"Type of listing: sale or rent."},"property_category":{"type":"string","nullable":true,"description":"Broad property category."},"property_type":{"type":"string","nullable":true,"description":"Specific property type."},"price":{"type":"integer","description":"Price of realestate."},"price_per_sqm":{"type":"number","description":"Price divided by total_sqm. Returned as an integer when there is no decimal part."},"total_sqm":{"type":"number","description":"Total surface of the property in square metres."},"rooms":{"type":"integer","description":"Total number of rooms."},"bedrooms":{"type":"integer","description":"Number of bedrooms."},"bathrooms":{"type":"integer","description":"Number of bathrooms."},"floor":{"type":"string","nullable":true,"description":"Floor description."},"has_elevator":{"type":"boolean","nullable":true,"description":"Whether the building has an elevator."},"heating":{"type":"string","nullable":true,"description":"Heating type."},"address":{"type":"string","nullable":true,"description":"Address of the listing."},"municipality":{"type":"string","nullable":true,"description":"Municipality (comune)."},"istat_code":{"type":"string","nullable":true,"description":"ISTAT code of the municipality."},"province":{"type":"string","nullable":true,"description":"Province name."},"province_code":{"type":"string","nullable":true,"description":"Two-letter province code (e.g. \"RM\")."},"region":{"type":"string","nullable":true,"description":"Region name."}}},"RealestateSearchData":{"type":"array","description":"Response for a normal search: a bare array of matching listings (empty when there are no matches). Each listing self-describes its own type via `type` (sale/rent).","items":{"$ref":"#/components/schemas/RealestateListing"}},"RealestateDryRunData":{"type":"object","description":"Response for a dry_run=1 request: no listing record is returned, only the total count of valid matches (search_radius, filters and validity rules applied, but not skip/limit).","properties":{"count":{"type":"integer","description":"Total number of valid matching listings for the given filters, independent of skip/limit."},"limit":{"type":"integer","description":"The limit value that would apply to a normal (non dry-run) request with the same parameters."}}},"AvgSqmHistoryEntry":{"type":"object","properties":{"date":{"type":"string","description":"Year and month this entry refers to (YYYY-MM)."},"average_price_per_sqm":{"type":"number","nullable":true,"description":"Average price per square metre for that month, in EUR."}}},"AvgSqmHistoryData":{"type":"object","properties":{"municipality":{"type":"string","description":"Municipality name."},"istat_code":{"type":"string","nullable":true,"description":"ISTAT code of the municipality."},"province":{"type":"string","nullable":true,"description":"Province abbreviation."},"type":{"type":"string","enum":["sale","rent"],"description":"Which history series this response contains."},"history":{"type":"array","items":{"$ref":"#/components/schemas/AvgSqmHistoryEntry"},"description":"Monthly entries sorted by date ascending, restricted to the requested date range (inclusive). Empty when the municipality has no data for the selected type, or when the requested range does not overlap the available history."}},"required":["municipality","type","history"]},"OmiPrevalentPropertyType":{"type":"string","nullable":true,"description":"Label of the prevalent property type for the OMI zone. Can be null or empty."},"OmiZoneDetails":{"type":"object","properties":{"description":{"type":"string","nullable":true,"description":"Free-text description of the OMI zone. Null when zone details are unavailable."},"prevalent_property_type":{"$ref":"#/components/schemas/OmiPrevalentPropertyType"}}},"OmiValueRange":{"type":"object","properties":{"min":{"type":"number","nullable":true,"description":"Minimum value. Null when not available (never converted to 0)."},"max":{"type":"number","nullable":true,"description":"Maximum value. Null when not available (never converted to 0)."}}},"OmiValue":{"type":"object","properties":{"property_type":{"type":"string","nullable":true,"description":"Property type label for this valuation row (e.g. \"Abitazioni civili\")."},"condition":{"type":"string","nullable":true,"description":"Maintenance condition this valuation row refers to (e.g. \"NORMALE\", \"OTTIMO\")."},"sale":{"allOf":[{"$ref":"#/components/schemas/OmiValueRange"}],"description":"Sale value range, in EUR per square metre."},"rent":{"allOf":[{"$ref":"#/components/schemas/OmiValueRange"}],"description":"Rent value range, in EUR per square metre per month."}}},"OmiData":{"type":"object","properties":{"location":{"$ref":"#/components/schemas/RealestateLocation"},"region":{"type":"string","nullable":true,"description":"Region name. Can be null."},"province_code":{"type":"string","nullable":true,"description":"Province abbreviation (e.g. \"RM\"). Can be null."},"municipality":{"type":"string","nullable":true,"description":"Municipality name. Can be null."},"istat_code":{"type":"string","nullable":true,"description":"ISTAT code. Can be null."},"cadastral_code":{"type":"string","nullable":true,"description":"Belfiore cadastral code of the municipality. Can be null."},"omi_zone":{"type":"string","nullable":true,"description":"OMI zone code (e.g. \"B1\"). Can be null."},"zone":{"$ref":"#/components/schemas/OmiZoneDetails"},"values":{"type":"array","items":{"$ref":"#/components/schemas/OmiValue"},"description":"One entry per property type/condition combination available for this zone and period. Empty array when no valuation data is available."},"geometry":{"type":"array","items":{"type":"object","properties":{"exterior":{"type":"array","items":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"}}},"description":"Outer boundary of this polygon part, as a list of {lat, lng} points (closed ring: the last point repeats the first)."},"holes":{"type":"array","items":{"type":"array","items":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"}}}},"description":"Interior boundaries excluded from this polygon part (holes), if any. Empty array when the part has no holes."}}},"description":"The polygon(s) of the OMI zone. One element per disjoint polygon part (most zones have exactly one); each element carries its own exterior boundary and any holes."}}}}},"paths":{"/IT-rm_value":{"post":{"tags":["Real Market Value"],"summary":"Retrieve property transaction details and  information","description":"The rm_value 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. Some requests may be processed asynchronously. In these cases, the API returns a request ID that can be used to retrieve the result via GET endpoints. A callback can also be configured to receive automatic notifications when the request is completed.\n\n  `immobili_residenziali`:\n  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.\n  \n  **In this category fall all the codes listed below**:\n  \n \n  **A01\n  A02\n  A03\n  A04\n  A05\n  A06\n  A07\n  A08\n  A09\n  A11**\n  \n  \n  `immobili_non_residenziali`:\n  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.\n   \n  **In this category fall all the codes listed below**:\n  \n  \n  **A10\n  C01\n  C02\n  C03\n  C04\n  C06\n  D01\n  D02\n  D03\n  D05\n  D06\n  D07\n  D08\n  D10**\n  \n  `pertinenziali`:\n  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.\n   \n  **In this category fall all the codes listed below**:\n  \n \n  **C02\n  C06**\n\nThe mandatory fields are:\n- **property_type**\n- **address** or **latitude** and **longitude** \n","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/CallbackOptions"},"property_type":{"type":"string","description":"Description of the property type","enum":["immobili_residenziali","immobili_non_residenziali","pertinenziali"]},"address":{"type":"string","description":"Property address. It must be composed of at least 5 alphanumeric characters and cannot exceed 255 characters.","example":"via schivardi 6, ROMA"},"latitude":{"type":"number","description":"Latitude coordinate in Decimal-degree.","example":41.237037},"longitude":{"type":"number","description":"Longitude coordinate in Decimal-degree.","example":16.502849},"search_radius":{"type":"integer","description":"Search area expressed in meters. Minimum value: 50, maximum value: 20000. Default: 250 if not declared.","minimum":50,"maximum":20000,"default":250,"example":250},"min_amount":{"type":"integer","description":"Minimum search amount in euros. Integers without punctuation. Not used as a selective criterion if not declared.","example":100000},"max_amount":{"type":"integer","description":"Maximum search amount in euros. Integers without punctuation. Not used as a selective criterion if not declared.","example":900000},"start_year":{"type":"integer","description":"Start year of the search. Integer from 2019. If not declared, the last 2 years are considered.","minimum":2019,"example":2019},"start_month":{"type":"string","description":"Start month of the search. Value between 01 and 12 (zero-padded). If not declared, the current month of the last 2 years is considered.","example":"01"},"end_year":{"type":"integer","description":"End year of the search. Integer corresponding to the end year of the search. If not declared, the last 2 years are considered.","example":2023},"end_month":{"type":"string","description":"End month of the search. Value between 01 and 12 (zero-padded). If not declared, the current month of the last 2 years is considered.","example":"01"},"cc":{"type":"array","items":{"type":"string","description":"Contract type selected from the list in description es: A10 C01 C02 C03 C04              C06 D01 D02 D03 D05 D06 D07 D08 D10.\n","example":"A01"}}},"required":["address","property_type"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/rm_value_completed"},{"$ref":"#/components/schemas/request_pending"}]}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"examples":{"completed":{"summary":"Completed request","description":"The request has been successfully processed and full data is available.","value":{"data":{"id":"66002f1a8e1a1234567890ab","created_at":"2026-03-20T13:51:36.937+00:00","owner":"test_user","stato":"evasa","params":{"property_type":"immobili_residenziali","address":"via schivardi 6, ROMA","latitude":"41.237037","longitude":"16.502849","search_radius":250,"min_amount":100000,"max_amount":900000,"start_year":2019,"start_month":"01","end_year":2023,"end_month":"01","cc":["A01"]},"esito":"OK","sales":[{"keycode":"cd06ee2fef0b46dbbcf86569aae0586c","price":439500,"property_type":"Residenziale singolo","sale_date":"2023-02-01","location":{"lat":41.8057123,"lng":12.4385838},"total_sqm":157,"distance":0.017519356902882553,"properties":[{"category_code":"C02","property_category":"Residenziale","sqm":6,"effective_sqm":1.5,"address":"VIA ANTONIO SCHIVARDI, 36","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"2","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":6}},{"category_code":"C06","property_category":"Residenziale","sqm":31,"effective_sqm":15.5,"address":"VIA ANTONIO SCHIVARDI, 36","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"2","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":31}},{"category_code":"A02","property_category":"Residenziale","sqm":140,"effective_sqm":140,"address":"VIA ANTONIO SCHIVARDI, 36","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"2","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":140}}]},{"keycode":"f2863b325e9c4908a73099c1010ed9c8","price":148769,"property_type":"Residenziale singolo","sale_date":"2023-10-01","location":{"lat":41.8057123,"lng":12.4385838},"total_sqm":128,"distance":0.017519356902882553,"properties":[{"category_code":"C02","property_category":"Residenziale","sqm":8,"effective_sqm":2,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":8}},{"category_code":"A02","property_category":"Residenziale","sqm":126,"effective_sqm":126,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":126}}]},{"keycode":"de9126af2749423b819cac2b0eea8967","price":450000,"property_type":"Residenziale singolo","sale_date":"2023-05-01","location":{"lat":41.8057123,"lng":12.4385838},"total_sqm":146,"distance":0.017519356902882553,"properties":[{"category_code":"C06","property_category":"Residenziale","sqm":16,"effective_sqm":8,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":16}},{"category_code":"A02","property_category":"Residenziale","sqm":138,"effective_sqm":138,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":138}}]},{"keycode":"44dc00bdf3034f068938c9bc987a80be","price":530000,"property_type":"Residenziale singolo","sale_date":"2022-10-01","location":{"lat":41.8060644,"lng":12.4384177},"total_sqm":186,"distance":0.02519723025055234,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":170,"effective_sqm":170,"address":"VIA ANTONIO SCHIVARDI, 7","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":170}},{"category_code":"C06","property_category":"Residenziale","sqm":32,"effective_sqm":16,"address":"VIA ANTONIO SCHIVARDI, 7","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2022","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":32}}]},{"keycode":"105fdd509ed84c05a5395b4eef6c652b","price":535000,"property_type":"Residenziale singolo","sale_date":"2023-01-01","location":{"lat":41.8056608,"lng":12.4380928},"total_sqm":171.5,"distance":0.03637843321278157,"properties":[{"category_code":"C06","property_category":"Residenziale","sqm":12,"effective_sqm":6,"address":"VIA ILDEBRANDO VIVANTI, 174","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":12}},{"category_code":"C06","property_category":"Residenziale","sqm":17,"effective_sqm":8.5,"address":"VIA ILDEBRANDO VIVANTI, 174","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":17}},{"category_code":"A02","property_category":"Residenziale","sqm":157,"effective_sqm":157,"address":"VIA ILDEBRANDO VIVANTI, 174","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":157}}]},{"keycode":"e5401ba77592470dbd9eff40dfa7b1eb","price":473000,"property_type":"Residenziale singolo","sale_date":"2023-01-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":148,"distance":0.09045102193209242,"properties":[{"category_code":"C02","property_category":"Residenziale","sqm":12,"effective_sqm":3,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":12}},{"category_code":"A02","property_category":"Residenziale","sqm":145,"effective_sqm":145,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":145}}]},{"keycode":"RM102022050412","price":170247,"property_type":"Residenziale singolo","sale_date":"2022-05-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":162.5,"distance":0.09045102193209242,"properties":[{"category_code":"C06","property_category":"Residenziale","sqm":11,"effective_sqm":5.5,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2022","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO  VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":11}},{"category_code":"A02","property_category":"Residenziale","sqm":157,"effective_sqm":157,"address":"VIALE BEATA VERGINE DEL CARMELO 000181","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO  VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":157}}]},{"keycode":"47434eebd71a445dbe26103c975f80e9","price":172732,"property_type":"Residenziale singolo","sale_date":"2022-09-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":154,"distance":0.09045102193209242,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":154,"effective_sqm":154,"address":"VIALE BEATA VERGINE DEL CARMELO, 149","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"9","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":1,"surface_sqm":154}}]},{"keycode":"30a1db4b89d8479685ce904f399ec572","price":385000,"property_type":"Residenziale singolo","sale_date":"2022-09-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":155,"distance":0.09045102193209242,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":155,"effective_sqm":155,"address":"VIALE BEATA VERGINE DEL CARMELO, 149","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"9","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":1,"surface_sqm":155}}]},{"keycode":"3d03e256828048b58ce75197def2fb03","price":480000,"property_type":"Residenziale singolo","sale_date":"2023-06-01","location":{"lat":41.8050856,"lng":12.4391081},"total_sqm":187,"distance":0.09961142405776394,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":171,"effective_sqm":171,"address":"VIA ANTONIO SCHIVARDI 000045","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"6","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":171}},{"category_code":"C06","property_category":"Residenziale","sqm":32,"effective_sqm":16,"address":"VIA ANTONIO SCHIVARDI 000045","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"6","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":32}}]}]},"success":true,"message":"","error":null}},"processing":{"summary":"Request in progress","description":"The request is still being processed. Only id and stato are available.","value":{"data":{"id":"69bd678d25c19edb7502d43b","stato":"in_erogazione"},"success":true,"message":"","error":null}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":611,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"417":{"description":"Not Acceptable","content":{"application/json":{"example":{"success":false,"message":"service temoporarily not available","error":201,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"Value address not set or invalid length for address","error":228,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"summary":"Callback for message status updates","description":"When a callback URL is provided in the request, our system will send an asynchronous POST request to that URL whenever the state of the message changes.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/rm_value_completed"},"example":{"data":{"id":"66002f1a8e1a1234567890ab","created_at":"2026-03-20T13:51:36.937+00:00","owner":"test_user","stato":"evasa","params":{"property_type":"immobili_residenziali","address":"via schivardi 6, ROMA","latitude":"41.237037","longitude":"16.502849","search_radius":250,"min_amount":100000,"max_amount":900000,"start_year":2019,"start_month":"01","end_year":2023,"end_month":"01","cc":["A01"]},"esito":"OK","sales":[{"keycode":"cd06ee2fef0b46dbbcf86569aae0586c","price":439500,"property_type":"Residenziale singolo","sale_date":"2023-02-01","location":{"lat":41.8057123,"lng":12.4385838},"total_sqm":157,"distance":0.017519356902882553,"properties":[{"category_code":"C02","property_category":"Residenziale","sqm":6,"effective_sqm":1.5,"address":"VIA ANTONIO SCHIVARDI, 36","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"2","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":6}},{"category_code":"C06","property_category":"Residenziale","sqm":31,"effective_sqm":15.5,"address":"VIA ANTONIO SCHIVARDI, 36","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"2","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":31}},{"category_code":"A02","property_category":"Residenziale","sqm":140,"effective_sqm":140,"address":"VIA ANTONIO SCHIVARDI, 36","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"2","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":140}}]},{"keycode":"f2863b325e9c4908a73099c1010ed9c8","price":148769,"property_type":"Residenziale singolo","sale_date":"2023-10-01","location":{"lat":41.8057123,"lng":12.4385838},"total_sqm":128,"distance":0.017519356902882553,"properties":[{"category_code":"C02","property_category":"Residenziale","sqm":8,"effective_sqm":2,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":8}},{"category_code":"A02","property_category":"Residenziale","sqm":126,"effective_sqm":126,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":126}}]},{"keycode":"de9126af2749423b819cac2b0eea8967","price":450000,"property_type":"Residenziale singolo","sale_date":"2023-05-01","location":{"lat":41.8057123,"lng":12.4385838},"total_sqm":146,"distance":0.017519356902882553,"properties":[{"category_code":"C06","property_category":"Residenziale","sqm":16,"effective_sqm":8,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":16}},{"category_code":"A02","property_category":"Residenziale","sqm":138,"effective_sqm":138,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":138}}]},{"keycode":"44dc00bdf3034f068938c9bc987a80be","price":530000,"property_type":"Residenziale singolo","sale_date":"2022-10-01","location":{"lat":41.8060644,"lng":12.4384177},"total_sqm":186,"distance":0.02519723025055234,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":170,"effective_sqm":170,"address":"VIA ANTONIO SCHIVARDI, 7","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":170}},{"category_code":"C06","property_category":"Residenziale","sqm":32,"effective_sqm":16,"address":"VIA ANTONIO SCHIVARDI, 7","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2022","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":32}}]},{"keycode":"105fdd509ed84c05a5395b4eef6c652b","price":535000,"property_type":"Residenziale singolo","sale_date":"2023-01-01","location":{"lat":41.8056608,"lng":12.4380928},"total_sqm":171.5,"distance":0.03637843321278157,"properties":[{"category_code":"C06","property_category":"Residenziale","sqm":12,"effective_sqm":6,"address":"VIA ILDEBRANDO VIVANTI, 174","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":12}},{"category_code":"C06","property_category":"Residenziale","sqm":17,"effective_sqm":8.5,"address":"VIA ILDEBRANDO VIVANTI, 174","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":17}},{"category_code":"A02","property_category":"Residenziale","sqm":157,"effective_sqm":157,"address":"VIA ILDEBRANDO VIVANTI, 174","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":157}}]},{"keycode":"e5401ba77592470dbd9eff40dfa7b1eb","price":473000,"property_type":"Residenziale singolo","sale_date":"2023-01-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":148,"distance":0.09045102193209242,"properties":[{"category_code":"C02","property_category":"Residenziale","sqm":12,"effective_sqm":3,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":12}},{"category_code":"A02","property_category":"Residenziale","sqm":145,"effective_sqm":145,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":145}}]},{"keycode":"RM102022050412","price":170247,"property_type":"Residenziale singolo","sale_date":"2022-05-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":162.5,"distance":0.09045102193209242,"properties":[{"category_code":"C06","property_category":"Residenziale","sqm":11,"effective_sqm":5.5,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2022","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO  VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":11}},{"category_code":"A02","property_category":"Residenziale","sqm":157,"effective_sqm":157,"address":"VIALE BEATA VERGINE DEL CARMELO 000181","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO  VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":157}}]},{"keycode":"47434eebd71a445dbe26103c975f80e9","price":172732,"property_type":"Residenziale singolo","sale_date":"2022-09-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":154,"distance":0.09045102193209242,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":154,"effective_sqm":154,"address":"VIALE BEATA VERGINE DEL CARMELO, 149","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"9","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":1,"surface_sqm":154}}]},{"keycode":"30a1db4b89d8479685ce904f399ec572","price":385000,"property_type":"Residenziale singolo","sale_date":"2022-09-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":155,"distance":0.09045102193209242,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":155,"effective_sqm":155,"address":"VIALE BEATA VERGINE DEL CARMELO, 149","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"9","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":1,"surface_sqm":155}}]},{"keycode":"3d03e256828048b58ce75197def2fb03","price":480000,"property_type":"Residenziale singolo","sale_date":"2023-06-01","location":{"lat":41.8050856,"lng":12.4391081},"total_sqm":187,"distance":0.09961142405776394,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":171,"effective_sqm":171,"address":"VIA ANTONIO SCHIVARDI 000045","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"6","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":171}},{"category_code":"C06","property_category":"Residenziale","sqm":32,"effective_sqm":16,"address":"VIA ANTONIO SCHIVARDI 000045","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"6","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":32}}]}]},"custom":null}}}},"responses":{"200":{"$ref":"#/components/schemas/Callback200"},"400":{"$ref":"#/components/schemas/Callback400"}}}}}},"security":[{"bearerAuth":[]}]},"get":{"tags":["Real Market Value"],"summary":"Extracts all requests","description":"This method allows you to see all the requests","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/list_item"}}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"example":{"data":[{"params":{"property_type":"immobili_residenziali","address":"via schivardi 6, ROMA","search_radius":250,"min_amount":100000,"max_amount":900000,"start_year":2019,"start_month":"01","end_year":2023,"end_month":"01","cc":["A01"]},"owner":"test@email.it","stato":"evasa","callback":false,"esito":"OK","id":"69b966314152d429bb0b8c8e","created_at":"2026-03-01T14:50:01+00:00"},{"params":{"property_type":"immobili_residenziali","address":"via schivardi 6, ROMA","search_radius":250,"min_amount":100000,"max_amount":900000,"start_year":2019,"start_month":"01","end_year":2023,"end_month":"01","cc":["A01"]},"owner":"test@email.it","stato":"evasa","callback":false,"esito":"OK","id":"69b966314152d429bb0b8c8e","created_at":"2026-03-10T13:50:01+00:00"}],"success":true,"message":"","error":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"Not requests found","error":232,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/IT-rm_value/{id}":{"get":{"tags":["Real Market Value"],"summary":"Detail of the real market value","description":"Allows you to see the detail of the real market value identified by the id","parameters":[{"name":"id","in":"path","description":"real market value id","required":true,"schema":{"type":"string","example":"628e41900e304d63044f857d"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"$ref":"#/components/schemas/rm_value_completed"}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"examples":{"completed":{"summary":"Completed request","value":{"data":{"id":"66002f1a8e1a1234567890ab","created_at":"2026-03-20T16:07:27.107+00:00","owner":"test_user","stato":"evasa","params":{"property_type":"immobili_residenziali","address":"via schivardi 6, ROMA","latitude":41.237037,"longitude":16.502849,"search_radius":250,"min_amount":100000,"max_amount":900000,"start_year":2019,"start_month":"01","end_year":2023,"end_month":"01","cc":["A01"]},"esito":"OK","sales":[{"keycode":"cd06ee2fef0b46dbbcf86569aae0586c","price":439500,"property_type":"Residenziale singolo","sale_date":"2023-02-01","location":{"lat":41.8057123,"lng":12.4385838},"total_sqm":157,"distance":0.017519356902882553,"properties":[{"category_code":"C02","property_category":"Residenziale","sqm":6,"effective_sqm":1.5,"address":"VIA ANTONIO SCHIVARDI, 36","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"2","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":6}},{"category_code":"C06","property_category":"Residenziale","sqm":31,"effective_sqm":15.5,"address":"VIA ANTONIO SCHIVARDI, 36","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"2","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":31}},{"category_code":"A02","property_category":"Residenziale","sqm":140,"effective_sqm":140,"address":"VIA ANTONIO SCHIVARDI, 36","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"2","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":140}}]},{"keycode":"f2863b325e9c4908a73099c1010ed9c8","price":148769,"property_type":"Residenziale singolo","sale_date":"2023-10-01","location":{"lat":41.8057123,"lng":12.4385838},"total_sqm":128,"distance":0.017519356902882553,"properties":[{"category_code":"C02","property_category":"Residenziale","sqm":8,"effective_sqm":2,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":8}},{"category_code":"A02","property_category":"Residenziale","sqm":126,"effective_sqm":126,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":126}}]},{"keycode":"de9126af2749423b819cac2b0eea8967","price":450000,"property_type":"Residenziale singolo","sale_date":"2023-05-01","location":{"lat":41.8057123,"lng":12.4385838},"total_sqm":146,"distance":0.017519356902882553,"properties":[{"category_code":"C06","property_category":"Residenziale","sqm":16,"effective_sqm":8,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":16}},{"category_code":"A02","property_category":"Residenziale","sqm":138,"effective_sqm":138,"address":"VIA ANTONIO SCHIVARDI 000010","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":138}}]},{"keycode":"44dc00bdf3034f068938c9bc987a80be","price":530000,"property_type":"Residenziale singolo","sale_date":"2022-10-01","location":{"lat":41.8060644,"lng":12.4384177},"total_sqm":186,"distance":0.02519723025055234,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":170,"effective_sqm":170,"address":"VIA ANTONIO SCHIVARDI, 7","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":170}},{"category_code":"C06","property_category":"Residenziale","sqm":32,"effective_sqm":16,"address":"VIA ANTONIO SCHIVARDI, 7","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2022","sale_month":"10","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":32}}]},{"keycode":"105fdd509ed84c05a5395b4eef6c652b","price":535000,"property_type":"Residenziale singolo","sale_date":"2023-01-01","location":{"lat":41.8056608,"lng":12.4380928},"total_sqm":171.5,"distance":0.03637843321278157,"properties":[{"category_code":"C06","property_category":"Residenziale","sqm":12,"effective_sqm":6,"address":"VIA ILDEBRANDO VIVANTI, 174","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":12}},{"category_code":"C06","property_category":"Residenziale","sqm":17,"effective_sqm":8.5,"address":"VIA ILDEBRANDO VIVANTI, 174","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":17}},{"category_code":"A02","property_category":"Residenziale","sqm":157,"effective_sqm":157,"address":"VIA ILDEBRANDO VIVANTI, 174","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":3,"surface_sqm":157}}]},{"keycode":"e5401ba77592470dbd9eff40dfa7b1eb","price":473000,"property_type":"Residenziale singolo","sale_date":"2023-01-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":148,"distance":0.09045102193209242,"properties":[{"category_code":"C02","property_category":"Residenziale","sqm":12,"effective_sqm":3,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":12}},{"category_code":"A02","property_category":"Residenziale","sqm":145,"effective_sqm":145,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"1","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":145}}]},{"keycode":"RM102022050412","price":170247,"property_type":"Residenziale singolo","sale_date":"2022-05-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":162.5,"distance":0.09045102193209242,"properties":[{"category_code":"C06","property_category":"Residenziale","sqm":11,"effective_sqm":5.5,"address":"VIALE BEATA VERGINE DEL CARMELO 000143","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2022","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO  VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":11}},{"category_code":"A02","property_category":"Residenziale","sqm":157,"effective_sqm":157,"address":"VIALE BEATA VERGINE DEL CARMELO 000181","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"5","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO  VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":157}}]},{"keycode":"47434eebd71a445dbe26103c975f80e9","price":172732,"property_type":"Residenziale singolo","sale_date":"2022-09-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":154,"distance":0.09045102193209242,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":154,"effective_sqm":154,"address":"VIALE BEATA VERGINE DEL CARMELO, 149","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"9","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":1,"surface_sqm":154}}]},{"keycode":"30a1db4b89d8479685ce904f399ec572","price":385000,"property_type":"Residenziale singolo","sale_date":"2022-09-01","location":{"lat":41.8065811,"lng":12.4389099},"total_sqm":155,"distance":0.09045102193209242,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":155,"effective_sqm":155,"address":"VIALE BEATA VERGINE DEL CARMELO, 149","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2022","sale_month":"9","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":1,"surface_sqm":155}}]},{"keycode":"3d03e256828048b58ce75197def2fb03","price":480000,"property_type":"Residenziale singolo","sale_date":"2023-06-01","location":{"lat":41.8050856,"lng":12.4391081},"total_sqm":187,"distance":0.09961142405776394,"properties":[{"category_code":"A02","property_category":"Residenziale","sqm":171,"effective_sqm":171,"address":"VIA ANTONIO SCHIVARDI 000045","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"RES","office_code":"RM10","sale_year":"2023","sale_month":"6","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":171}},{"category_code":"C06","property_category":"Residenziale","sqm":32,"effective_sqm":16,"address":"VIA ANTONIO SCHIVARDI 000045","details":{"cadastral_code":"H501","omi_zone":"D82","market_sector":"PER","office_code":"RM10","sale_year":"2023","sale_month":"6","region":"Lazio","province":"RM","city":"Roma","area":"EUR MOSTACCIANO - VIALE BEATA VERGINE DEL CARMELO","total_properties":2,"surface_sqm":32}}]}]},"success":true,"message":"","error":null}},"processing":{"summary":"Request in progress","value":{"data":{"id":"69c11f2f9f123c7d010704c2","created_at":"2026-03-17T11:08:31.000+00:00","owner":"test_user","stato":"in_erogazione","params":{"property_type":"immobili_residenziali","address":"via schivardi 6, ROMA","latitude":"41.237037","longitude":"16.502849","search_radius":250,"min_amount":100000,"max_amount":900000,"start_year":2019,"start_month":"01","end_year":2023,"end_month":"01","cc":["A01"]},"esito":null,"sales":null},"success":true,"message":"","error":null}}}}}}}}},"/IT-sqm_value_start":{"post":{"tags":["Square Meter Value"],"summary":"Retrieve basic property information","description":"The SQM endpoint provides users with detailed information on the value per square meter of properties in a given region. Through parameters such as property type, location, and contract, users can obtain precise data to assess price trends and plan strategic real estate investments. The 'type' parameter offers a selection of property types, such as residential buildings, offices, shops, warehouses, and more, each associated with a unique numerical ID.\n\nThe 'type' parameter allows selection from various property types, including:\n- 1: Ville e Villini\n- 5: Negozi\n- 6: Uffici\n- 7: Capannoni tipici\n- 8: Capannoni industriali\n- 9: Magazzini\n- 10: Laboratori\n- 13: Box e Autorimesse\n- 14: Posto auto coperti\n- 15: Posto auto scoperti\n- 19: Abitazioni in stabili signorili\n- 20: Abitazioni in stabili civili\n- 21: Abitazioni in stabili economici\n","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/CallbackOptions"},"address":{"type":"string","description":"Property address. It must be composed of at least 5 alphanumeric characters and cannot exceed 255 characters.","example":"via schivardi 6, ROMA"},"for":{"type":"string","description":"'Contract type: 'rent' for Rent, 'sale' for Sale'","enum":["rent","sale"]},"type":{"type":"number","description":"Property type: '20' for Residential Buildings, '19' for Luxury Residential Buildings, '21' for Affordable Residential Buildings, '1' for Villas and Cottages, '6' for Offices, '5' for Shops, '13' for Garages and Parking Spaces, '14' for Covered Parking Spaces, '15' for Uncovered Parking Spaces, '9' for Warehouses, '10' for Laboratories, '7' for Typical Warehouses, '8' for Industrial Warehouses","enum":[20,19,21,1,6,5,13,14,15,9,10,7,8]}},"required":["for","type","address"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/sqm_value_start"}}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"examples":{"completed":{"summary":"Completed request","value":{"data":{"nome":"Eur Mostacciano Viale Beata Vergine Del Carmelo","citta":"Roma","cod_cat":"H501","provincia":"RM","regione":"Lazio","fascia":"semicentrale","address":"via schivardi 6, ROMA","formatted":"Via Antonio Schivardi, 6, 00144 Roma RM, Italia","loc2011":"5809112","coordinate":{"lat":41.80584,"lng":12.43846},"immobile":{"type":"Abitazioni in stabili civili","label":"Valori di Affitto Abitazioni in stabili civili al Mq","id":20},"quotazione":{"min":10.95,"max":16.03,"med":13.49,"type":"rent","anno":2023,"semestre":2},"id":"66002f1a8e1a1234567890ab"},"success":true,"message":"","error":null}},"processing":{"summary":"Request in progress","value":{"data":{"id":"69bd678d25c19edb7502d43b","stato":"in_erogazione"},"success":true,"message":"","error":null}},"wrong_request":{"summary":"Wrong address","value":{"data":{"params":{"address":"via abcd, ROMA","type":20,"for":"rent"},"owner":"test_user","stato":"evasa","esito":"wrong address","id":"69c11fd79f123c7d010704c3","created_at":"2026-03-11T11:11:19.000+00:00"},"success":true,"message":"","error":null}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":611,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service temoporarily not available","error":202,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"Value address not set or invalid length for address","error":200,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"summary":"Callback for message status updates","description":"When a callback URL is provided in the request, our system will send an asynchronous POST request to that URL whenever the state of the message changes.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sqm_value_start"},"example":{"data":{"nome":"Eur Mostacciano Viale Beata Vergine Del Carmelo","citta":"Roma","cod_cat":"H501","provincia":"RM","regione":"Lazio","fascia":"semicentrale","address":"via schivardi 6, ROMA","formatted":"Via Antonio Schivardi, 6, 00144 Roma RM, Italia","loc2011":"5809112","coordinate":{"lat":41.80584,"lng":12.43846},"immobile":{"type":"Abitazioni in stabili civili","label":"Valori di Affitto Abitazioni in stabili civili al Mq","id":20},"quotazione":{"min":10.95,"max":16.03,"med":13.49,"type":"rent","anno":2023,"semestre":2},"id":"66002f1a8e1a1234567890ab"},"custom":null}}}},"responses":{"200":{"$ref":"#/components/schemas/Callback200"},"400":{"$ref":"#/components/schemas/Callback400"}}}}}},"security":[{"bearerAuth":[]}]},"get":{"tags":["Square Meter Value"],"summary":"Extracts all requests","description":"This method allows you to see all the requests","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/list_item"}}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"example":{"data":[{"params":{"address":"via schivardi 6, ROMA","for":"rent","type":20},"owner":"test@email.it","stato":"evasa","callback":false,"esito":"OK","id":"69b966314152d429bb0b8c8e","created_at":"2026-03-01T14:50:01+00:00"},{"params":{"address":"via schivardi 6, ROMA","for":"rent","type":20},"owner":"test@email.it","stato":"evasa","callback":false,"esito":"OK","id":"69b966314152d429bb0b8c8e","created_at":"2026-03-10T13:50:01+00:00"}],"success":true,"message":"","error":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"Not requests found","error":232,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/IT-sqm_value_start/{id}":{"get":{"tags":["Square Meter Value"],"summary":"Detail of the square meter value","description":"Allows you to see the detail of the square meter value identified by the id","parameters":[{"name":"id","in":"path","description":"square meter value id","required":true,"schema":{"type":"string","example":"628e41900e304d63044f857d"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"$ref":"#/components/schemas/sqm_value_start"}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"examples":{"completed":{"summary":"Completed request","value":{"data":{"nome":"Eur Mostacciano Viale Beata Vergine Del Carmelo","citta":"Roma","cod_cat":"H501","provincia":"RM","regione":"Lazio","fascia":"semicentrale","address":"via schivardi 6, ROMA","formatted":"Via Antonio Schivardi, 6, 00144 Roma RM, Italia","loc2011":"5809112","coordinate":{"lat":41.80584,"lng":12.43846},"immobile":{"type":"Abitazioni in stabili civili","label":"Valori di Affitto Abitazioni in stabili civili al Mq","id":20},"quotazione":{"min":10.95,"max":16.03,"med":13.49,"type":"rent","anno":2023,"semestre":2},"id":"66002f1a8e1a1234567890ab"},"success":true,"message":"","error":null}},"processing":{"summary":"Request in progress","value":{"data":{"params":{"address":"via schivardi 6, ROMA","type":20,"for":"rent"},"owner":"test_user","stato":"in_erogazione","id":"69c11fd79f123c7d010704c3","created_at":"2026-03-11T11:11:19.000+00:00"},"success":true,"message":"","error":null}}}}}}}}},"/IT-sqm_value_advanced":{"post":{"tags":["Square Meter Value"],"summary":"Retrieve detailed property information including sales and demographic data","description":"The SQM Advanced endpoint enhances the standard SQM service by providing comprehensive insights into property valuation trends and market dynamics. In addition to the core parameters available in the basic SQM endpoint, the Advanced endpoint offers additional data fields, including:\n\nDetailed breakdowns of property sales distribution by type, facilitating a deeper understanding of market segmentation.\n\nDemographic statistics such as population density, household composition, education levels, and employment rates, offering valuable socio-economic context for investment decisions.\n\nGeographic information including altitude, local administrative divisions, and seismic risk assessment, providing crucial geographical insights for risk management and location-based strategies.\n\nTimeliness metrics indicating average selling durations across different property size categories, aiding in forecasting and decision-making processes.\n\nThis enriched dataset empowers users with comprehensive analytics to make informed real estate investment decisions and optimize portfolio strategies.\n\nIn some cases, the request may complete successfully but return a non-positive outcome. This is indicated by the 'esito' field (e.g. 'wrong address'), meaning that the request was processed but no valid results could be produced based on the provided input.\n\nThe 'type' parameter allows selection from various property types, including:\n- 1: Ville e Villini\n- 5: Negozi\n- 6: Uffici\n- 7: Capannoni tipici\n- 8: Capannoni industriali\n- 9: Magazzini\n- 10: Laboratori\n- 13: Box e Autorimesse\n- 14: Posto auto coperti\n- 15: Posto auto scoperti\n- 19: Abitazioni in stabili signorili\n- 20: Abitazioni in stabili civili\n- 21: Abitazioni in stabili economici\n","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/CallbackOptions"},"address":{"type":"string","description":"Property address. It must be composed of at least 5 alphanumeric characters and cannot exceed 255 characters.","example":"via schivardi 6, ROMA"},"for":{"type":"string","description":"'Contract type: 'rent' for Rent, 'sale' for Sale'","enum":["rent","sale"]},"type":{"type":"number","description":"Property type: '20' for Residential Buildings, '19' for Luxury Residential Buildings, '21' for Affordable Residential Buildings, '1' for Villas and Cottages, '6' for Offices, '5' for Shops, '13' for Garages and Parking Spaces, '14' for Covered Parking Spaces, '15' for Uncovered Parking Spaces, '9' for Warehouses, '10' for Laboratories, '7' for Typical Warehouses, '8' for Industrial Warehouses","enum":[20,19,21,1,6,5,13,14,15,9,10,7,8]}},"required":["for","type","address"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"$ref":"#/components/schemas/sqm_value_advanced"}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"examples":{"completed":{"summary":"Completed request","value":{"data":{"nome":"Eur Mostacciano Viale Beata Vergine Del Carmelo","citta":"Roma","cod_cat":"H501","provincia":"RM","regione":"Lazio","fascia":"semicentrale","address":"via schivardi 6 Roma","formatted":"Via Antonio Schivardi, 6, 00144 Roma RM, Italia","loc2011":"5809112","coordinate":{"lat":41.80584,"lng":12.43846},"immobile":{"type":"Abitazioni in stabili civili","label":"Valori di Vendita Abitazioni in stabili civili al Mq","id":20},"quotazione":{"min":2371,"max":3476,"med":2924,"type":"sale"},"ripartizione_annunci":{"vendita":{"1":{"tipologia":"Appartamenti","percentuale":75.52},"2":{"tipologia":"Locali ed Uffici","percentuale":12.590000000000002},"12":{"tipologia":"Ville e Villini","percentuale":6.29},"14":{"tipologia":"Box e Garage","percentuale":5.59}},"affitto":{"1":{"tipologia":"Appartamenti","percentuale":51.22},"2":{"tipologia":"Locali ed Uffici","percentuale":36.59},"14":{"tipologia":"Box e Garage","percentuale":12.2}}},"dimensioni":[{"label":"0-50 Mq","percentuale":12.04},{"label":"50-85 Mq","percentuale":27.78},{"label":"85-115 Mq","percentuale":12.96},{"label":"115-145 Mq","percentuale":11.11},{"label":"Oltre 145 Mq","percentuale":36.11}],"capoluoghi_vendite_zona":{"2019":{"num_abitazioni_zona":"4451","numero_abitazioni_vendute":"190","perc_variazione_annuale":"67.770","dinamicita_mercato_residenziale":"molto alta"},"2020":{"num_abitazioni_zona":"4451","numero_abitazioni_vendute":"105","perc_variazione_annuale":"-44.65","dinamicita_mercato_residenziale":"Medio alta"},"2021":{"num_abitazioni_zona":"4451","numero_abitazioni_vendute":"144","perc_variazione_annuale":"37.086","dinamicita_mercato_residenziale":"alta"},"2022":{"num_abitazioni_zona":"4679","numero_abitazioni_vendute":"139","perc_variazione_annuale":"-3.4722","dinamicita_mercato_residenziale":"medio alta"}},"demografico":{"pop":{"media_componenti_famiglia":"2.19","dimensione_nuclei_familiari":"medi","livello_anzianita":"medio basso","livello_istruzione":"superiore alla media","livello_disoccupazione":"bassa"},"stock":{"abitanti_per_edificio":"18.41","abitazioni_per_edificio":"8.29","prc_edifici_produttivi_commerciali":"17.000","prc_edifici_residenziali":"81.000","mq_abitazione_media":"100.02","prc_abitazioni_di_proprieta":"73.000","prc_abitazioni_vuote_o_2_case":"7.000"},"geo":{"id":"282","loc2011":"5809112","id_provincia":"86","cod_cat":"H501","tipo_localita":"Municipio","nome_localita":"XII Municipio","altitudine":"0"},"rischio_sismico":"medio","capoluogo":[{"media_num_abitazioni_zona":"4586.2857","media_numero_abitazioni_vendute":"139.4286","dinamicita_mercato_residenziale":"alta"}]},"tempistiche":[[{"label":"0 50 Mq","media_giorni":169},{"label":"50 85 Mq","media_giorni":178},{"label":"85 115 Mq","media_giorni":150},{"label":"115 145 Mq","media_giorni":161},{"label":"Oltre 145 Mq","media_giorni":145}]],"id":"66002f1a8e1a1234567890ab"},"success":true,"message":"","error":null}},"processing":{"summary":"Request in progress","value":{"data":{"id":"69bd678d25c19edb7502d43b","stato":"in_erogazione"},"success":true,"message":"","error":null}},"wrong_request":{"summary":"Wrong address","value":{"data":{"params":{"address":"via abcd, ROMA","type":20,"for":"rent"},"owner":"test_user","stato":"evasa","esito":"wrong address","id":"69c11fd79f123c7d010704c3","created_at":"2026-03-11T11:11:19.000+00:00"},"success":true,"message":"","error":null}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet: 200 > 1.1935842939015E-12 code 810","error":611,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"417":{"description":"Expectation Failed","content":{"application/json":{"example":{"success":false,"message":"service temoporarily not available","error":202,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"428":{"description":"Precondition Required","content":{"application/json":{"example":{"success":false,"message":"Value address not set or invalid length for address","error":200,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"summary":"Callback for message status updates","description":"When a callback URL is provided in the request, our system will send an asynchronous POST request to that URL whenever the state of the message changes.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sqm_value_advanced"},"example":{"data":{"nome":"Eur Mostacciano Viale Beata Vergine Del Carmelo","citta":"Roma","cod_cat":"H501","provincia":"RM","regione":"Lazio","fascia":"semicentrale","address":"via schivardi 6 Roma","formatted":"Via Antonio Schivardi, 6, 00144 Roma RM, Italia","loc2011":"5809112","coordinate":{"lat":41.80584,"lng":12.43846},"immobile":{"type":"Abitazioni in stabili civili","label":"Valori di Vendita Abitazioni in stabili civili al Mq","id":20},"quotazione":{"min":2371,"max":3476,"med":2924,"type":"sale"},"ripartizione_annunci":{"vendita":{"1":{"tipologia":"Appartamenti","percentuale":75.52},"2":{"tipologia":"Locali ed Uffici","percentuale":12.590000000000002},"12":{"tipologia":"Ville e Villini","percentuale":6.29},"14":{"tipologia":"Box e Garage","percentuale":5.59}},"affitto":{"1":{"tipologia":"Appartamenti","percentuale":51.22},"2":{"tipologia":"Locali ed Uffici","percentuale":36.59},"14":{"tipologia":"Box e Garage","percentuale":12.2}}},"dimensioni":[{"label":"0-50 Mq","percentuale":12.04},{"label":"50-85 Mq","percentuale":27.78},{"label":"85-115 Mq","percentuale":12.96},{"label":"115-145 Mq","percentuale":11.11},{"label":"Oltre 145 Mq","percentuale":36.11}],"capoluoghi_vendite_zona":{"2019":{"num_abitazioni_zona":"4451","numero_abitazioni_vendute":"190","perc_variazione_annuale":"67.770","dinamicita_mercato_residenziale":"molto alta"},"2020":{"num_abitazioni_zona":"4451","numero_abitazioni_vendute":"105","perc_variazione_annuale":"-44.65","dinamicita_mercato_residenziale":"Medio alta"},"2021":{"num_abitazioni_zona":"4451","numero_abitazioni_vendute":"144","perc_variazione_annuale":"37.086","dinamicita_mercato_residenziale":"alta"},"2022":{"num_abitazioni_zona":"4679","numero_abitazioni_vendute":"139","perc_variazione_annuale":"-3.4722","dinamicita_mercato_residenziale":"medio alta"}},"demografico":{"pop":{"media_componenti_famiglia":"2.19","dimensione_nuclei_familiari":"medi","livello_anzianita":"medio basso","livello_istruzione":"superiore alla media","livello_disoccupazione":"bassa"},"stock":{"abitanti_per_edificio":"18.41","abitazioni_per_edificio":"8.29","prc_edifici_produttivi_commerciali":"17.000","prc_edifici_residenziali":"81.000","mq_abitazione_media":"100.02","prc_abitazioni_di_proprieta":"73.000","prc_abitazioni_vuote_o_2_case":"7.000"},"geo":{"id":"282","loc2011":"5809112","id_provincia":"86","cod_cat":"H501","tipo_localita":"Municipio","nome_localita":"XII Municipio","altitudine":"0"},"rischio_sismico":"medio","capoluogo":[{"media_num_abitazioni_zona":"4586.2857","media_numero_abitazioni_vendute":"139.4286","dinamicita_mercato_residenziale":"alta"}]},"tempistiche":[[{"label":"0 50 Mq","media_giorni":169},{"label":"50 85 Mq","media_giorni":178},{"label":"85 115 Mq","media_giorni":150},{"label":"115 145 Mq","media_giorni":161},{"label":"Oltre 145 Mq","media_giorni":145}]],"id":"66002f1a8e1a1234567890ab"},"custom":null}}}},"responses":{"200":{"$ref":"#/components/schemas/Callback200"},"400":{"$ref":"#/components/schemas/Callback400"}}}}}},"security":[{"bearerAuth":[]}]},"get":{"tags":["Square Meter Value"],"summary":"Extracts all requests","description":"This method allows you to see all the requests","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/list_item"}}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"example":{"data":[{"params":{"address":"via schivardi 6, ROMA","for":"rent","type":20},"owner":"test@email.it","stato":"evasa","callback":false,"esito":"OK","id":"69b966314152d429bb0b8c8e","created_at":"2026-03-01T14:50:01+00:00"},{"params":{"address":"via schivardi 6, ROMA","for":"rent","type":20},"owner":"test@email.it","stato":"evasa","callback":false,"esito":"OK","id":"69b966314152d429bb0b8c8e","created_at":"2026-03-10T13:50:01+00:00"}],"success":true,"message":"","error":null}}}},"404":{"description":"Not Found","content":{"application/json":{"example":{"success":false,"message":"Not requests found","error":232,"data":null},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/IT-sqm_value_advanced/{id}":{"get":{"tags":["Square Meter Value"],"summary":"Detail of the square meter value","description":"Allows you to see the detail of the square meter value identified by the id","parameters":[{"name":"id","in":"path","description":"square meter value id","required":true,"schema":{"type":"string","example":"628e41900e304d63044f857d"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"$ref":"#/components/schemas/sqm_value_advanced"}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"examples":{"completed":{"summary":"Completed request","value":{"data":{"nome":"Eur Mostacciano Viale Beata Vergine Del Carmelo","citta":"Roma","cod_cat":"H501","provincia":"RM","regione":"Lazio","fascia":"semicentrale","address":"via schivardi 6 Roma","formatted":"Via Antonio Schivardi, 6, 00144 Roma RM, Italia","loc2011":"5809112","coordinate":{"lat":41.80584,"lng":12.43846},"immobile":{"type":"Abitazioni in stabili civili","label":"Valori di Vendita Abitazioni in stabili civili al Mq","id":20},"quotazione":{"min":2371,"max":3476,"med":2924,"type":"sale"},"ripartizione_annunci":{"vendita":{"1":{"tipologia":"Appartamenti","percentuale":75.52},"2":{"tipologia":"Locali ed Uffici","percentuale":12.590000000000002},"12":{"tipologia":"Ville e Villini","percentuale":6.29},"14":{"tipologia":"Box e Garage","percentuale":5.59}},"affitto":{"1":{"tipologia":"Appartamenti","percentuale":51.22},"2":{"tipologia":"Locali ed Uffici","percentuale":36.59},"14":{"tipologia":"Box e Garage","percentuale":12.2}}},"dimensioni":[{"label":"0-50 Mq","percentuale":12.04},{"label":"50-85 Mq","percentuale":27.78},{"label":"85-115 Mq","percentuale":12.96},{"label":"115-145 Mq","percentuale":11.11},{"label":"Oltre 145 Mq","percentuale":36.11}],"capoluoghi_vendite_zona":{"2019":{"num_abitazioni_zona":"4451","numero_abitazioni_vendute":"190","perc_variazione_annuale":"67.770","dinamicita_mercato_residenziale":"molto alta"},"2020":{"num_abitazioni_zona":"4451","numero_abitazioni_vendute":"105","perc_variazione_annuale":"-44.65","dinamicita_mercato_residenziale":"Medio alta"},"2021":{"num_abitazioni_zona":"4451","numero_abitazioni_vendute":"144","perc_variazione_annuale":"37.086","dinamicita_mercato_residenziale":"alta"},"2022":{"num_abitazioni_zona":"4679","numero_abitazioni_vendute":"139","perc_variazione_annuale":"-3.4722","dinamicita_mercato_residenziale":"medio alta"}},"demografico":{"pop":{"media_componenti_famiglia":"2.19","dimensione_nuclei_familiari":"medi","livello_anzianita":"medio basso","livello_istruzione":"superiore alla media","livello_disoccupazione":"bassa"},"stock":{"abitanti_per_edificio":"18.41","abitazioni_per_edificio":"8.29","prc_edifici_produttivi_commerciali":"17.000","prc_edifici_residenziali":"81.000","mq_abitazione_media":"100.02","prc_abitazioni_di_proprieta":"73.000","prc_abitazioni_vuote_o_2_case":"7.000"},"geo":{"id":"282","loc2011":"5809112","id_provincia":"86","cod_cat":"H501","tipo_localita":"Municipio","nome_localita":"XII Municipio","altitudine":"0"},"rischio_sismico":"medio","capoluogo":[{"media_num_abitazioni_zona":"4586.2857","media_numero_abitazioni_vendute":"139.4286","dinamicita_mercato_residenziale":"alta"}]},"tempistiche":[[{"label":"0 50 Mq","media_giorni":169},{"label":"50 85 Mq","media_giorni":178},{"label":"85 115 Mq","media_giorni":150},{"label":"115 145 Mq","media_giorni":161},{"label":"Oltre 145 Mq","media_giorni":145}]],"id":"66002f1a8e1a1234567890ab"},"success":true,"message":"","error":null}},"processing":{"summary":"Request in progress","value":{"data":{"params":{"address":"via schivardi 6, ROMA","type":20,"for":"rent"},"owner":"test_user","stato":"in_erogazione","id":"69c11fd79f123c7d010704c3","created_at":"2026-03-11T11:11:19.000+00:00"},"success":true,"message":"","error":null}},"wrong_request":{"summary":"Wrong address","value":{"data":{"params":{"address":"via abcd, ROMA","type":20,"for":"rent"},"owner":"test_user","stato":"evasa","esito":"wrong address","id":"69c11fd79f123c7d010704c3","created_at":"2026-03-11T11:11:19.000+00:00"},"success":true,"message":"","error":null}}}}}}}}},"/IT-comparable":{"get":{"tags":["Real Estate Market Data"],"summary":"Search real estate listings near a point","description":"Searches individual property listings near the given geographic point, sorted by distance ascending.","parameters":[{"name":"latitude","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90,"example":45.4642},"description":"Latitude of the search point, in decimal degrees."},{"name":"longitude","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180,"example":9.19},"description":"Longitude of the search point, in decimal degrees."},{"name":"search_radius","in":"query","required":false,"schema":{"type":"number","example":5000},"description":"Maximum distance from the search point, in meters. Optional: when omitted, the nearest valid listings are returned with no maximum distance. Mandatory (and must be > 0) when dry_run=1, in which case it also cannot exceed 100,000 meters (100 km)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"example":20},"description":"Maximum number of listings to return. Default 20, minimum 1, maximum 100."},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"example":0},"description":"Number of matching listings to skip before returning results, ordered by distance ascending."},{"name":"min_amount","in":"query","required":false,"schema":{"type":"number","example":100000,"minimum":0},"description":"Minimum price, must be >= 0. If max_amount is also set, max_amount must be at least 20,000 greater than min_amount when type=sale (default), or at least 300 greater when type=rent."},{"name":"max_amount","in":"query","required":false,"schema":{"type":"number","example":300000,"minimum":0},"description":"Maximum price, cannot be lower than min_amount. Must be >= 0. If min_amount is also set, it must be at least 20,000 lower than max_amount when type=sale (default), or at least 300 lower when type=rent."},{"name":"min_sqm","in":"query","required":false,"schema":{"type":"number","example":50,"minimum":0},"description":"Minimum total surface in square metres. Must be >= 0."},{"name":"max_sqm","in":"query","required":false,"schema":{"type":"number","example":150,"minimum":0},"description":"Maximum total surface in square metres. Cannot be lower than min_sqm. Must be >= 0."},{"name":"min_rooms","in":"query","required":false,"schema":{"type":"number","example":2,"minimum":0},"description":"Minimum number of rooms. Must be >= 0."},{"name":"max_rooms","in":"query","required":false,"schema":{"type":"number","example":5,"minimum":0},"description":"Maximum number of rooms. Cannot be lower than min_rooms. Must be >= 0."},{"name":"min_bedrooms","in":"query","required":false,"schema":{"type":"number","example":1,"minimum":0},"description":"Minimum number of bedrooms. Must be >= 0."},{"name":"max_bedrooms","in":"query","required":false,"schema":{"type":"number","example":3,"minimum":0},"description":"Maximum number of bedrooms. Cannot be lower than min_bedrooms. Must be >= 0."},{"name":"min_bathrooms","in":"query","required":false,"schema":{"type":"number","example":1,"minimum":0},"description":"Minimum number of bathrooms. Must be >= 0."},{"name":"max_bathrooms","in":"query","required":false,"schema":{"type":"number","example":2,"minimum":0},"description":"Maximum number of bathrooms. Cannot be lower than min_bathrooms. Must be >= 0."},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["sale","rent"],"default":"sale"},"description":"Filter by type."},{"name":"property_category","in":"query","required":false,"schema":{"type":"string","enum":["Capannoni","Commerciale","Garage","Magazzini","Negozi","Nuove costruzioni","Palazzi","Residenziale","Terreni","Uffici"]},"description":"Filter by property category."},{"name":"dry_run","in":"query","required":false,"schema":{"type":"string","enum":["0","1"],"default":"0"},"description":"When set to 1, no listing is returned: the response only reports the total number of valid matches (see 200 response `dry_run` example). search_radius becomes mandatory in this case. When omitted or 0, behaves as a normal search."}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"oneOf":[{"$ref":"#/components/schemas/RealestateSearchData"},{"$ref":"#/components/schemas/RealestateDryRunData"}]}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"examples":{"sales":{"summary":"Normal search","value":{"data":[{"type":"sale","property_category":"Residenziale","property_type":"Appartamento","price":180000,"price_per_sqm":2250,"total_sqm":80,"rooms":3,"bedrooms":2,"bathrooms":1,"floor":"2","has_elevator":true,"heating":"Autonomo","address":"Via del Corso","municipality":"Roma","istat_code":"058091","province":"Roma","province_code":"RM","region":"Lazio"}],"success":true,"message":"","error":null}},"rents":{"summary":"type=rent","value":{"data":[{"type":"rent","property_category":"Residenziale","property_type":"Villa a schiera","price":1800,"price_per_sqm":12,"total_sqm":150,"rooms":5,"bedrooms":3,"bathrooms":2,"floor":"piano terra","has_elevator":false,"heating":"Centralizzato","address":"Via Garibaldi 12","municipality":"Milano","istat_code":"015146","province":"Milano","province_code":"MI","region":"Lombardia"}],"success":true,"message":"","error":null}},"dry_run":{"summary":"dry_run=1","value":{"data":{"count":137,"limit":20},"success":true,"message":"","error":null}},"empty":{"summary":"No matching listings","value":{"data":[],"success":true,"message":"No listings available for the selected search criteria.","error":null}}}}}},"400":{"description":"Returned when the request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"message":"latitude and longitude are required","error":241,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet","error":611,"data":null}}}}}}},"/IT-avg_sqm_value_history":{"get":{"tags":["Real Estate Market Data"],"summary":"Monthly average price-per-sqm history for a municipality","description":"Returns the monthly average price-per-square-metre history (sale or rent) for a municipality, optionally restricted to a requested date range.","parameters":[{"name":"municipality","in":"query","required":true,"schema":{"type":"string","example":"Roma"},"description":"Municipality name."},{"name":"province","in":"query","required":false,"schema":{"type":"string","example":"RM"},"description":"Two-letter Italian province code."},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["sale","rent"],"default":"sale"},"description":"Which type to return."},{"name":"start_year","in":"query","required":false,"schema":{"type":"integer","example":2023},"description":"Four-digit start year of the requested range. Optional; required if start_month is supplied."},{"name":"start_month","in":"query","required":false,"schema":{"type":"string","example":"06"},"description":"Start month, 1-12. Requires start_year to be set."},{"name":"end_year","in":"query","required":false,"schema":{"type":"integer","example":2024},"description":"Four-digit end year of the requested range. Optional; required if end_month is supplied."},{"name":"end_month","in":"query","required":false,"schema":{"type":"string","example":"03"},"description":"End month, 1-12. Requires end_year to be set."}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AvgSqmHistoryData"}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"examples":{"history":{"summary":"Result","value":{"data":{"municipality":"Roma","istat_code":"058091","province":"RM","type":"sale","history":[{"date":"2025-01","average_price_per_sqm":3200},{"date":"2025-02","average_price_per_sqm":3220}]},"success":true,"message":"","error":null}},"no_overlap":{"summary":"Empty","value":{"data":{"municipality":"Roma","istat_code":"058091","province":"RM","type":"sale","history":[]},"success":true,"message":"No data available for the selected date range.","error":null}}}}}},"400":{"description":"Returned when the request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"message":"Invalid value for type, must be sale or rent","error":270,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet","error":611,"data":null}}}},"404":{"description":"Not Found. Returned when the requested municipality does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"message":"Municipality not found","error":278,"data":null}}}}}}},"/IT-omi":{"get":{"tags":["OMI Zones"],"summary":"OMI zone and valuation ranges for a point","description":"Finds the official OMI (Osservatorio del Mercato Immobiliare) zone whose polygon contains the given point, then returns the zone details, its geometry and all available valuation ranges (sale and rent, per property type and condition) for that zone.","parameters":[{"name":"latitude","in":"query","required":true,"schema":{"type":"number","minimum":-90,"maximum":90,"example":42.5157},"description":"Latitude of the point."},{"name":"longitude","in":"query","required":true,"schema":{"type":"number","minimum":-180,"maximum":180,"example":12.297},"description":"Longitude of the point."}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"data":{"$ref":"#/components/schemas/OmiData"}}},{"$ref":"#/components/schemas/ApiEnvelope"}]},"examples":{"found":{"summary":"Point falls inside an OMI zone","value":{"data":{"location":{"lat":41.8425085,"lng":12.4569508},"region":"LAZIO","province_code":"RM","municipality":"ROMA","istat_code":"12058091","cadastral_code":"H501","omi_zone":"D8","zone":{"description":"MAGLIANA (VIA DELL`IMPRUNETA)","prevalent_property_type":"Abitazioni civili"},"values":[{"property_type":"Abitazioni civili","condition":"NORMALE","sale":{"min":2100,"max":2900},"rent":{"min":9.5,"max":13.5}},{"property_type":"Abitazioni di tipo economico","condition":"NORMALE","sale":{"min":1850,"max":2550},"rent":{"min":8.8,"max":12.3}},{"property_type":"Box","condition":"NORMALE","sale":{"min":1250,"max":1750},"rent":{"min":6.3,"max":9}},{"property_type":"Capannoni industriali","condition":"NORMALE","sale":{"min":480,"max":730},"rent":{"min":3.8,"max":6}},{"property_type":"Laboratori","condition":"NORMALE","sale":{"min":800,"max":1150},"rent":{"min":5.8,"max":8.3}},{"property_type":"Negozi","condition":"NORMALE","sale":{"min":1400,"max":2000},"rent":{"min":10.5,"max":15}},{"property_type":"Posti auto coperti","condition":"NORMALE","sale":{"min":950,"max":1300},"rent":{"min":5.3,"max":7.3}},{"property_type":"Posti auto scoperti","condition":"NORMALE","sale":{"min":550,"max":800},"rent":{"min":3.3,"max":4.5}},{"property_type":"Uffici","condition":"NORMALE","sale":{"min":1700,"max":2500},"rent":{"min":10.3,"max":14.8}}],"geometry":[{"exterior":[{"lat":41.841,"lng":12.455},{"lat":41.843,"lng":12.456},{"lat":41.844,"lng":12.458},{"lat":41.842,"lng":12.4575},{"lat":41.841,"lng":12.455}],"holes":[]}]},"success":true,"message":"","error":null}},"not_found":{"summary":"Point does not fall inside any OMI zone","value":{"data":{},"success":true,"message":"No OMI zone found for the given coordinates","error":null}}}}}},"400":{"description":"Returned when the request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"message":"Invalid value for latitude, must be between -90 and 90","error":281,"data":null}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"success":false,"message":"Billing error message: Insufficient Credit in Wallet","error":611,"data":null}}}}}}}},"externalDocs":{"description":"First time here? Generate a new access token","url":"https://console.openapi.com/oauth"}}