Il servizio Ricerca Persona appartiene all'API Catasto e consente di accedere alle informazioni aggiornate sugli immobili intestati ad un soggetto in una determinata provincia.

Il servizio è identificato dall'endpoint https://catasto.openapi.it/richiesta/ricerca_persona

La ricerca può essere effettuata sia su soggetto privato sia giuridico e sia per il catasto Fabbricato sia Terreno, oppure su entrambi contemporaneamente.

ESEMPIO RICHIESTA POST /ricerca_persona

Il metodo da utilizzare nella richiesta è POST. Segue un esempio di chiamata all'endpoint ricerca_persona:

POST https://catasto.openapi.it/richiesta/ricerca_persona

I parametri da passare nel body della richiesta sono:

• codice Fiscale o partita IVA
• tipo di catasto (T per terreno o F per Fabbricato)
• provincia

Questo è un esempio dei parametri necessari per una richiesta con tipo di catasto 'Fabbricato': 

{
      "cf_piva": "12485671007",    
      "tipo_catasto": "F",
      "provincia": "RM",
    }

La risposta è asincrona. È possibile impostare, in fase di richiesta, anche una callback per essere aggiornati su quando i dati saranno disponibili, senza dover chiamare più volte l'endpoint GET /richiesta/{id} per verificarne lo stato.

ESEMPIO RISPOSTA POST /ricerca_persona

La risposta includerà i parametri utilizzati in fase di richiesta più l'ID della richiesta: 

{
  "data": {
    "endpoint": "ricerca_persona",
    "stato": "in_erogazione",
    "callback": false,
    "parametri": {
      "cf_piva": "12485671007",      
      "tipo_catasto": "F",
      "provincia": "ROMA Territorio-RM"      
    },
    "risultato": null,
    "esito": null,
    "timestamp": 1716374985,
    "owner": "[email protected]",
    "id": "664dcdc97de11b2d0426430f"
  },
  "success": true,
  "message": "",
  "error": null
}

ESEMPIO RICHIESTA GET /richiesta/{id}

Per ottenere i dati sarà necessario effettuare una seconda richiesta, come anticipato, ad un altro endpoint con l'id precedentemente ottenuto.

Questo è un esempio di richiesta di ricerca persona utilizzando l'ID risultato dalla chiamata precedente (664dcdc97de11b2d0426430f):

GET https://catasto.openapi.it/richiesta/664dcdc97de11b2d0426430f

ESEMPIO RISPOSTA GET /richiesta/{id}

Anche in questo caso i dati presenti nella risposta includeranno i parametri utilizzati in fase di richiesta ed informazioni sugli immobili o terreni compatibili con la ricerca. 

Nel caso in cui la ricerca sia stata effettuata su tipo di catasto 'Fabbricato', le informazioni saranno le seguenti:

• nome o denominazione intestatario
• sede
• codice fiscale intestatario
• tipologia proprietà
• id_soggetto
• titolarità
• indirizzo (ubicazione)
• comune
• codice catastale
• classamento
• classe
• consistenza
• rendita
• id_immobile

 Questo è un esempio di risposta:

{
  "data": {
    "endpoint": "ricerca_persona",
    "stato": "evasa",
    "callback": false,
    "parametri": {
      "cf_piva": "12485671007",
      "tipo_catasto": "F",
      "provincia": "ROMA Territorio-RM"     
    },
    "risultato": {
      "soggetti": [
            {
             "denominazione": "OPENAPI SRL con sede in ROMA (RM)",
             "sede": "ROMA (RM)",
             "cf": "12485671007",
             "id_soggetto": "1111efff3cwxwewecwfdwedwqddwwed",
             "immobili": [
                {
                  "catasto": "F
                  "titolarita": "Proprieta' superficiaria per 1/1",
                  "ubicazione": "ROMA VIALE FILIPPO TOMMASO MARINETTI, SNC Piano S2 int. 1",
                  "comune": "ROMA",
                  "provincia": "RM",
                  "codice_catastale": "H501",
                  "sezione": null,
                  "sezione_urbana": null,
                  "foglio": 872,
                  "particella": 405,
                  "subalterno": 48,
                  "classamemto": "zona6 cat. A/10",        
                  "classe": "1",
                  "consistenza": "3,5 vani",
                  "rendita": "Euro:108,09",
                  "id_immobile": "saf1sf9djosaj0asdaljf93jfjkdkjsòfrjòjsdfòajdsòjfòsjf"          
            }
          ]
        }
      ]
    },
    "esito": "OK",
    "timestamp": 1625232029,
    "owner": "[email protected]",
    "id": "60e581c58138e80d804dad20"
  },
  "success": true,
  "message": "",
  "error": null
}

Nella risposta saranno disponibili anche gli ID degli immobili/terreni e ID soggetto, che potranno essere utilizzati per effettuare una richiesta diretta di visura catastale immobile (ordinaria o storica) con l'endpoint dedicato.