National Mortgage Inspection - Italy

Openapi provides access to all the main services for searches in the Land Registry and the Territorial Agency office, via API and in real time:

The National Mortgage Inspection specifically allows a nationwide verification of mortgages (excluding those in the autonomous provinces of Trieste, Trento, and Bolzano, where the Tavolare Cadastre system applies) and provides a list of all provincial registry offices where formalities related to a specific subject are registered. 

The document will indicate the registry office and the type of formality registered for each office (registration, transcription, etc.).  The inspection can be requested for both private individuals and companies.

REQUEST NATIONAL MORTGAGE INSPECTION

The National Mortgage Inspection allows you to verify mortgages at a national level and is available for both private individuals and companies.

The document includes a list of provincial offices of the Land Registries where any formalities registered against the person being researched will appear. The National Inspection will indicate the type of formality recorded for each Registry (registration, transcription, etc.).

Request Document Hash

GET /visure

To proceed with the National Mortgage Inspection request via the Visengine API, first, you need to find the hash that uniquely identifies each document or practice.

https://visengine2.altravia.com/visure/

This is possible through the GET /visure endpoint, which does not require parameters and will return the complete list of documents and practices available via Visengine and their respective hashes.

Verify Data and Costs for National Mortgage Inspection Request

GET /visure/{hash_visura}

To verify the information, necessary documents, and costs of the national inspection, you need to make a request through the GET /visure/{hash_visura} endpoint and provide the hash of the National Mortgage Inspection previously obtained.

REQUEST EXAMPLE

GET /visure/{hash_visura}

To verify fields and costs to complete the request, you should use the hash obtained from the previous request.

https://visengine2.altravia.com/visure/5c7ac7018245b6262803f75d6aa58a90

RESPONSE EXAMPLE

GET /visure/{hash_visura}

The response will indicate all the necessary information to complete the National Mortgage Inspection request, such as required fields.

{ 
  "data": {
    "hash_visura": "5c7ac7018245b6262803f75d6aa58a90",
    "json_struttura": {
      "campi": {
        "$0": {
          "nome": "Codice Fiscale Persona","
          "tipo": "codice_fiscale_persona_fisica",
          "null": true,
          "istruzioni": "Inserisci il codice fiscale del privato per cui stai richiedendo la visura ipocatastale"
        },
        "$1": {
          "nome": "Codice Fiscale Azienda",
          "tipo": "codice_fiscale_persona_giuridica",
          "null": true,
          "istruzioni": "Inserisci il codice fiscale dell`azienda per cui stai richiedendo la visura ipocatastale",
          "ordine": "1"
        },
        "$2": {
          "nome": "Telefono o Email per Essere Ricontattati in Caso di Problemi*",
          "tipo": "testo",
          "null": false,
          "ordine": "2"
        }
      },
      "validazione": "($0 || $1) && $2",
    "nome_categoria": "Catastali",
    "nome_visura": "Visura Ipocatastale per Immobile",
    "opzioni": null,
    "prezzo_ricerca": 0,
    "prezzo_visura": 23.7,
    "ricerca": false,
    "sincrona": false,
  },
  "success": true,
  "message": "",
  "error": null
}

The validation field shows the mandatory data needed to successfully complete the request.

In the case of the National Mortgage Inspection, it is possible to pass different combinations of data based on the information available.

Request the National Mortgage Inspection

POST /richiesta

In the payload of the request, you should pass all the information and documents indicated previously.

{
      "hash_visura": "3cbbb9c833f1c94af35494820cda3370",
      "json_visura": {
        "$0": xxxxxxxxxxx,
        "$2": xxxxxxxxxxx

    }

RESPONSE EXAMPLE

POST /richiesta

The response provides various information, including the status, whether the callback is set, and the request ID, which will be needed later to download the document.

{ "data": 
    {
    "_id": "5f2829ce065afc21cc60ad0e",
    "state": 1,
    "hash_visura": "5c7ac7018245b6262803f75d6aa58a90",
    "nome": "Visura Ipocatastale Nazionale Agenzia Entrate",
    "ricerca": false,
    "id_ricerca": null,
    "prezzo_visura": 23.7,
    "prezzo_ricerca": 0,
    "indice_ricerca": null,
    "stato_richiesta": "In erogazione",
    "email_target": null,
    "allegati": [],
    "timestamp_creation": 1596467662,
    "timestamp_last_update": 1596467663,
    "timestamp_stati": {
      "in_ricerca": 1596467663,
      "in_erogazione": 1596467663
    },
    "callback_data": false,
    "opzioni": null,
    "owner": "[email protected]",
    "sincrona": false,
    "ricerche": [
      {
        "id_ricerca": "5f2829ce065afc21cc60ad0e_0",
        "stato_ricerca": "Ricerca evasa",
        "json_ricerca": "{}",
        "json_mappato": {},
        "json_risultato": null
      }
    ],
    "esito": {
      "codice": "0",
      "info": "OK"
    }

Download Document

GET /documento/{_id}

Once the request status is "completed", you can download the document using the GET method /document/{_id}

REQUEST EXAMPLE

GET /documento/{_id}

This is an example request using the ID obtained previously.

https://visengine2.altravia.com/visure/document/5f2829ce065afc21cc60ad0e

RESPONSE EXAMPLE

GET /documento/{_id}

The response will contain the name, size, and file.

{
  data{
    "nome":"5f22f5b5065afc21cc60a27a.zip",
    "dimensione"10206",
    "file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
    },
    "success": true,
    "message": "",
    "error": null
  }

The mortgage inspection can be requested by anyone, even if they do not hold real rights on the properties.