{"openapi":"3.0.0","info":{"title":"Catasto","version":"3.0.0","description":"Diese API bietet strukturierten Zugriff auf offizielle italienische Grundbuchdaten zu **Immobilien** und **Rechtssubjekten** (natürliche und juristische Personen).\n\nAlle von dieser API bereitgestellten POST-Endpunkte sind in der Produktionsumgebung asynchron. Jede Anfrage wird entgegengenommen und asynchron verarbeitet. In der sandbox-Umgebung verhalten sich die POST-Endpunkte synchron und geben eine simulierte Antwort zurück, die ausschließlich zu Test- und Integrationszwecken dient.\n\n### **Katasterdaten**\nDie API ermöglicht die Abfrage des italienischen Katasters, um detaillierte Informationen über Gebäude und Grundstücke sowie deren REGISTERED Eigentümer abzurufen. Es ist möglich:\n- Katasterdaten zu einer bestimmten Immobilie abzufragen\n- die REGISTERED Eigentümer einer Immobilie zu ermitteln\n- die Liste der Immobilien abzurufen, die sich im Besitz einer natürlichen oder juristischen Person befinden\n- detaillierte Beschreibungen der mit einer Person verbundenen Immobilien zu erhalten\n- die Gesamtzahl der Grundstücke und Gebäude zu ermitteln, die sich im Besitz einer Person befinden\n- die Liste der Immobilien abzurufen, die sich an einer bestimmten Adresse befinden\n\n### **Katasterauszüge**\nDie API umfasst die Erstellung von Katasterauszügen (Visure Catastali) sowohl für Immobilien als auch für Rechtsträger. Visure Catastali können als offizielle PDF-Dokumente, als XML-Dokumente und als JSON-Dokumente abgerufen werden. Die Formate XML und JSON liefern strukturierte Katasterauszugsdaten, die für die Software-Integration, die automatisierte Verarbeitung und die Datenextraktion vorgesehen sind.\n\n### **Visure Ipotecarie**\nDie API umfasst den Zugriff auf **Grundbuchauszüge (Visure Ipotecarie)**, die Informationen zu **Eintragungen (Vermerke/Formalitäten)** liefern, die mit Immobilien oder Rechtsträgern verbunden sind und von den italienischen Grundbuchämtern (Conservatorie) erfasst wurden.\nÜber die Grundbuchauskunftsdienste ist es möglich:\n- die Grundbuchämter zu ermitteln, bei denen für ein Objekt\n  Einträge (Vermerke/Formalitäten) vorliegen\n- die Liste der Einträge für ein Objekt oder eine Immobilie\n  innerhalb eines bestimmten Grundbuchamtes abzurufen\n- die detaillierten Informationen zu einem einzelnen Eintrag abzurufen\n\n### **Estratto Mappa**\nÜber diesen Dienst können Sie den Kartenauszug aus dem Grundbuch als PDF abrufen\n\n### **Elaborato Planimetrico**\nÜber diesen Dienst können Sie den Kataster-Grundriss als PDF abrufen\n\n### **Monitoraggio Catastale**\nDie API umfasst ein Katasterüberwachungssystem, mit dem Sie Überwachungsanfragen für Grundstücke und Rechtsträger erstellen können. Die Überwachung kann für Katasterdaten von Grundstücken, die Suche nach Rechtsträgern auf Provinzebene sowie die Suche nach Rechtsträgern auf nationaler Ebene konfiguriert werden. Wenn eine Callback-Adresse angegeben wird, benachrichtigt der Dienst die konfigurierte Callback-URL, sobald die erste Überprüfung abgeschlossen ist und bei jeder Änderung der überwachten Felder.","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://catasto.openapi.it","description":"Produktion"},{"url":"https://test.catasto.openapi.it","description":"Sandbox"}],"tags":[{"name":"Territorio","description":"Methoden, die die Abfrage von Provinzen, Gemeinden, Katasterbezirken und Grundbuchämtern (Conservatorie) auf italienischem Gebiet ermöglichen."},{"name":"Richiesta","description":"Verfahren, mit denen Sie eine Auskunftsanfrage zu Gebäuden oder Grundstücken beim Grundbuchamt erstellen und einsehen können"},{"name":"Indirizzo","description":"Methode, mit der Sie nach einer Adresse suchen können"},{"name":"Visura Catastale","description":"Verfahren, mit denen man einen Katasterauszug erhalten kann"},{"name":"Visura Ipotecaria","description":"Methoden zum Abrufen von Grundbuchvermerken (Formalitäten) zu Personen oder Grundstücken, einschließlich der Suche im Grundbuchamt, der Auflistung von Vermerken und der Anzeige von Vermerksdetails."},{"name":"Estratto Mappa","description":"Methoden, mit denen Sie einen Kartenausschnitt erhalten können"},{"name":"Elaborato Planimetrico","description":"Verfahren, mit denen Sie einen Katasterbauplan erhalten können"},{"name":"Monitoraggio","description":"System zur Überwachung von Katasterdaten."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"VisureIpotecarie":{"type":"object","properties":{"id":{"type":"string","example":"696e4fc6fb352796ad0dadf0"},"endpoint":{"type":"string","description":"Der Dienst, der die Anfrage generiert hat.","enum":["ispezione_nazionale","ispezione_elenco_note","ispezione_dettaglio_nota"],"example":"ispezione_nazionale"},"stato":{"type":"string","description":"Aktueller Bearbeitungsstatus.","enum":["evasa","in_lavorazione","in_erogazione"],"example":"evasa"},"timestamp":{"type":"integer","description":"Unix-Zeitstempel.","example":1768837062},"owner":{"type":"string","example":"test@email.it"}}},"BodyDettaglioNotaSoggettoGenerale":{"type":"object","required":["tipo_restrizione","tipo_registro","conservatoria","anno","registro_generale","cf_piva"],"properties":{"tipo_restrizione":{"type":"string","description":"Art der Einschränkung für die Prüfung.","enum":["soggetto_fisico","soggetto_giuridico"],"example":"soggetto_fisico"},"tipo_registro":{"type":"string","description":"Registrierungstyp.","enum":["generale"],"example":"generale"},"conservatoria":{"type":"string","description":"Identifikationsnummer oder Name des Grundbuchamtes.","example":"RM10-19971231-ROMA 1"},"anno":{"type":"integer","description":"Jahr (4 Ziffern).","example":2025},"registro_generale":{"type":"integer","description":"Allgemeine Registernummer.","example":10206},"cf_piva":{"type":"string","description":"Steuernummer (CF) oder Umsatzsteuer-Identifikationsnummer (P.IVA) des Betroffenen.","example":"RSSMRA80A01H501U"},"callback":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/Callback"}]},"richiedente":{"type":"string","nullable":true,"description":"Steueridentifikationsnummer des Antragstellers (Codice Fiscale).","example":"RSSMRA80A01H501U"},"motivo":{"type":"string","nullable":true,"description":"Grund für die Anfrage.","example":"verifica preliminare per compravendita"}}},"BodyDettaglioNotaSoggettoParticolare":{"type":"object","required":["tipo_restrizione","tipo_registro","conservatoria","anno","tipo_nota","registro_particolare","cf_piva"],"properties":{"tipo_restrizione":{"type":"string","enum":["soggetto_fisico","soggetto_giuridico"],"example":"soggetto_fisico"},"tipo_registro":{"type":"string","enum":["particolare"],"example":"particolare"},"conservatoria":{"type":"string","example":"RM10-19971231-ROMA 1"},"anno":{"type":"integer","description":"Jahr (4 Ziffern).","example":2025},"tipo_nota":{"type":"string","description":"Notiztyp (Kategorie).","enum":["trascrizioni","iscrizioni","annotazioni","privilegi_agrari","privilegi_speciali","privilegi_minerali"],"example":"trascrizioni"},"registro_particolare":{"type":"integer","description":"Spezifische Registernummer.","example":123456},"cf_piva":{"type":"string","example":"RSSMRA80A01H501U"},"callback":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/Callback"}]},"richiedente":{"type":"string","nullable":true,"example":"RSSMRA80A01H501U"},"motivo":{"type":"string","nullable":true,"example":"verifica preliminare per compravendita"}}},"BodyDettaglioNotaImmobileGenerale":{"type":"object","required":["tipo_restrizione","tipo_registro","conservatoria","anno","registro_generale","comune","tipo_catasto","foglio","particella"],"properties":{"tipo_restrizione":{"type":"string","enum":["immobile"],"example":"immobile"},"tipo_registro":{"type":"string","enum":["generale"],"example":"generale"},"conservatoria":{"type":"string","example":"RM10-19971231-ROMA 1"},"anno":{"type":"integer","description":"Jahr (4 Ziffern).","example":2025},"registro_generale":{"type":"integer","example":123456},"comune":{"type":"string","description":"Kennung oder Name der Gemeinde.","example":"H501#RMROMA##"},"tipo_catasto":{"type":"string","example":"F"},"foglio":{"type":"integer","example":405},"particella":{"type":"integer","example":875},"subalterno":{"type":"integer","nullable":true,"example":5},"sezione":{"type":"string","nullable":true},"sezione_urbana":{"type":"string","nullable":true,"example":""},"callback":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/Callback"}]},"richiedente":{"type":"string","nullable":true,"example":"RSSMRA80A01H501U"},"motivo":{"type":"string","nullable":true,"example":"verifica preliminare per compravendita"}}},"BodyDettaglioNotaImmobileParticolare":{"type":"object","required":["tipo_restrizione","tipo_registro","conservatoria","anno","tipo_nota","registro_particolare","comune","tipo_catasto","foglio","particella"],"properties":{"tipo_restrizione":{"type":"string","enum":["immobile"],"example":"immobile"},"tipo_registro":{"type":"string","enum":["particolare"],"example":"particolare"},"conservatoria":{"type":"string","example":"RM10-19971231-ROMA 1"},"anno":{"type":"integer","example":2025},"tipo_nota":{"type":"string","enum":["trascrizioni","iscrizioni","annotazioni","privilegi_agrari","privilegi_speciali","privilegi_minerali"],"example":"trascrizioni"},"registro_particolare":{"type":"integer","example":123456},"comune":{"type":"string","example":"H501#RMROMA##"},"tipo_catasto":{"type":"string","example":"F"},"foglio":{"type":"integer","example":405},"particella":{"type":"integer","example":875},"subalterno":{"type":"integer","nullable":true,"example":5},"sezione":{"type":"string","nullable":true},"sezione_urbana":{"type":"string","nullable":true,"example":""},"callback":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/Callback"}]},"richiedente":{"type":"string","nullable":true,"example":"RSSMRA80A01H501U"},"motivo":{"type":"string","nullable":true,"example":"verifica preliminare per compravendita"}}},"BodyIpotecarieDettaglioNota":{"oneOf":[{"$ref":"#/components/schemas/BodyDettaglioNotaSoggettoGenerale"},{"$ref":"#/components/schemas/BodyDettaglioNotaSoggettoParticolare"},{"$ref":"#/components/schemas/BodyDettaglioNotaImmobileGenerale"},{"$ref":"#/components/schemas/BodyDettaglioNotaImmobileParticolare"}],"discriminator":{"propertyName":"tipo_restrizione"}},"BodyElencoNoteImmobile":{"type":"object","required":["entita","comune","tipo_catasto","conservatoria","foglio","particella"],"properties":{"entita":{"type":"string","description":"Anfragetyp.","enum":["ispezione_immobile"],"example":"ispezione_immobile"},"comune":{"type":"string","description":"Name der Gemeinde.","example":"Roma"},"tipo_catasto":{"type":"string","description":"Katastertyp (z. B. F für „Fabbricati“, T für „Terreni“).","example":"F"},"conservatoria":{"type":"string","description":"Identifikationsnummer oder Name des Grundbuchamtes.","example":"ROMA 1"},"foglio":{"type":"integer","example":6},"particella":{"type":"integer","example":260},"subalterno":{"type":"integer","nullable":true,"example":5},"sezione":{"type":"string","nullable":true,"description":"Optionaler Katasterabschnitt."},"sezione_urbana":{"type":"string","nullable":true,"description":"Optionaler städtischer Abschnitt.","example":""}}},"BodyElencoNoteSoggetto":{"type":"object","required":["entita","conservatoria","cf_piva"],"properties":{"entita":{"type":"string","description":"Anfragetyp.","enum":["ispezione_soggetto"],"example":"ispezione_soggetto"},"conservatoria":{"type":"string","description":"Identifikationsnummer oder Name des Grundbuchamtes.","example":"terni"},"cf_piva":{"type":"string","description":"Steuernummer (CF) oder Umsatzsteuer-Identifikationsnummer (P.IVA) des Betroffenen.","example":"RSSMRA80A01H501U"}}},"BodyIpotecarieElencoNote":{"oneOf":[{"$ref":"#/components/schemas/BodyElencoNoteImmobile"},{"$ref":"#/components/schemas/BodyElencoNoteSoggetto"}],"discriminator":{"propertyName":"entita"}},"BodyIspezioneNazionale":{"type":"object","required":["cf_piva"],"properties":{"cf_piva":{"type":"string","description":"Steuernummer (CF) oder Umsatzsteuer-Identifikationsnummer (P.IVA) des Betroffenen.","example":"01114601006"},"callback":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/Callback"}]},"richiedente":{"type":"string","nullable":true,"description":"Steuernummer.","example":"RSSMRA80A01H501U"},"motivo":{"type":"string","nullable":true,"description":"Grund für die Anfrage.","example":"verifica preliminare per compravendita"}}},"risultatoIspezioneNazionale":{"oneOf":[{"$ref":"#/components/schemas/risultatoIspezioneNazionalePersona"},{"$ref":"#/components/schemas/risultatoIspezioneNazionaleSocieta"}],"discriminator":{"propertyName":"entita"}},"risultatoIspezioneNazionalePersona":{"type":"object","properties":{"risultato":{"type":"object","properties":{"soggetti":{"type":"array","items":{"$ref":"#/components/schemas/IspezioneNazionaleSoggettoFisico"}}}}}},"risultatoIspezioneNazionaleSocieta":{"type":"object","properties":{"risultato":{"type":"object","properties":{"soggetti":{"type":"array","items":{"$ref":"#/components/schemas/IspezioneNazionaleSoggettoGiuridico"}}}}}},"IspezioneNazionaleConservatoria":{"type":"object","properties":{"conservatoria":{"type":"string"},"trascrizioni":{"type":"string"},"iscrizioni":{"type":"string"},"annotazioni":{"type":"string"}}},"IspezioneNazionaleSoggettoFisico":{"type":"object","properties":{"cognome":{"type":"string"},"nome":{"type":"string"},"data_nascita":{"type":"string"},"sesso":{"type":"string"},"luogo_nascita":{"type":"string"},"cf":{"type":"string"},"conservatorie":{"type":"array","items":{"$ref":"#/components/schemas/IspezioneNazionaleConservatoria"}}}},"IspezioneNazionaleSoggettoGiuridico":{"type":"object","properties":{"denominazione":{"type":"string"},"sede":{"type":"string"},"cf":{"type":"string"},"conservatorie":{"type":"array","items":{"$ref":"#/components/schemas/IspezioneNazionaleConservatoria"}}}},"risultatoIspezioneElencoNote":{"oneOf":[{"$ref":"#/components/schemas/risultatoIspezioneElencoNoteImmobile"},{"$ref":"#/components/schemas/risultatoIspezioneElencoNoteSoggettoFisico"},{"$ref":"#/components/schemas/risultatoIspezioneElencoNoteSoggettoGiuridico"}],"discriminator":{"propertyName":"entita"}},"risultatoIspezioneElencoNoteImmobile":{"type":"object","properties":{"risultato":{"type":"object","properties":{"immobili":{"type":"array","items":{"$ref":"#/components/schemas/ElencoNoteImmobileItem"}}}}}},"ElencoNoteImmobileItem":{"type":"object","properties":{"identificativo_definitivo":{"$ref":"#/components/schemas/IdentificativoDefinitivo"},"identificativo_provvisorio":{"$ref":"#/components/schemas/IdentificativoProvvisorio"},"note":{"type":"array","items":{"$ref":"#/components/schemas/NotaItem"}}}},"IdentificativoDefinitivo":{"type":"object","properties":{"sezione":{"type":"string","nullable":true},"sezione_urbana":{"type":"string","nullable":true},"foglio":{"type":"string"},"particella":{"type":"string"},"subalterno":{"type":"string"}}},"IdentificativoProvvisorio":{"type":"object","properties":{"tipo_denuncia":{"type":"string","nullable":true},"numero":{"type":"string","nullable":true},"anno":{"type":"string","nullable":true}}},"NotaItem":{"type":"object","required":["tipo_nota","data_nota","registro_particolare","registro_generale","pubblico_ufficiale","repertorio","data_repertorio","tipo_atto","citta","provincia","documenti_correlati"],"properties":{"tipo_nota":{"type":"string"},"data_nota":{"type":"string"},"registro_particolare":{"type":"string"},"registro_generale":{"type":"string"},"pubblico_ufficiale":{"type":"string"},"repertorio":{"type":"string"},"data_repertorio":{"type":"string"},"tipo_atto":{"type":"string"},"citta":{"type":"string"},"provincia":{"type":"string"},"documenti_correlati":{"type":"object","nullable":true}}},"risultatoIspezioneElencoNoteSoggettoFisico":{"type":"object","properties":{"risultato":{"type":"object","properties":{"soggetti":{"type":"array","items":{"$ref":"#/components/schemas/ElencoNoteSoggettoSoggettoFisicoItem"}}}}}},"ElencoNoteSoggettoSoggettoFisicoItem":{"type":"object","properties":{"cognome":{"type":"string"},"nome":{"type":"string"},"data_nascita":{"type":"string"},"luogo_nascita":{"type":"string"},"sesso":{"type":"string"},"cf":{"type":"string"},"note":{"type":"array","items":{"$ref":"#/components/schemas/NotaItem"}}}},"risultatoIspezioneElencoNoteSoggettoGiuridico":{"type":"object","properties":{"risultato":{"type":"object","properties":{"soggetti":{"type":"array","items":{"$ref":"#/components/schemas/ElencoNoteSoggettoGiuridicoItem"}}}}}},"ElencoNoteSoggettoGiuridicoItem":{"type":"object","properties":{"denominazione":{"type":"string"},"sede":{"type":"string"},"cf":{"type":"string"},"note":{"type":"array","items":{"$ref":"#/components/schemas/NotaItem"}}}},"risultatoDettaglioNota":{"type":"object","properties":{"risultato":{"type":"object","properties":{"nota":{"$ref":"#/components/schemas/DettaglioNota"}}}}},"DettaglioNota":{"type":"object","properties":{"tipo_nota":{"type":"string"},"data_nota":{"type":"string"},"registro_particolare":{"type":"string"},"registro_generale":{"type":"string"}}},"RispostaGetIpotecarie":{"type":"object","properties":{"endpoint":{"type":"string","example":"ispezione_elenco_note"},"stato":{"type":"string","example":"evasa"},"callback":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/Callback"}]},"parametri":{"type":"object","description":"Parameter, die zum Starten der Anfrage verwendet werden (variieren je nach Entität).","additionalProperties":true},"risultato":{"oneOf":[{"$ref":"#/components/schemas/risultatoIspezioneNazionale"},{"$ref":"#/components/schemas/risultatoIspezioneElencoNote"},{"$ref":"#/components/schemas/risultatoDettaglioNota"}],"discriminator":{"propertyName":"endpoint"}},"esito":{"type":"string","nullable":true},"documento":{"type":"string","nullable":true},"richiedente":{"type":"string","nullable":true,"example":"RSSMRA80C24H501J"},"motivo":{"type":"string","nullable":true,"example":"verifica preliminare per compravendita"},"timestamp":{"type":"integer","example":1768907012},"owner":{"type":"string","example":"test@email.it"},"id":{"type":"string","example":"696f6104fb66be7939088fa3"}}},"RispostaPostIpotecarie":{"type":"object","properties":{"endpoint":{"type":"string","example":"ispezione_elenco_note"},"stato":{"type":"string","example":"in_erogazione"},"callback":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/Callback"}]},"parametri":{"type":"object","description":"Wiederholung des Anfragetextes.","additionalProperties":true},"risultato":{"type":"object","nullable":true,"description":"In POST-Antworten immer null.\n"},"esito":{"type":"string","nullable":true},"documento":{"type":"string","nullable":true},"richiedente":{"type":"string","nullable":true,"example":"RSSMRA80C24H501J"},"motivo":{"type":"string","nullable":true,"example":"verifica preliminare per compravendita"},"timestamp":{"type":"integer","example":1768907012},"owner":{"type":"string","example":"test@email.it"},"id":{"type":"string","example":"696f6104fb66be7939088fa3"}}},"TipoCatasto":{"type":"string","enum":["T","F","TF"],"description":"- **T** = Terreni (Grundstücke) - **F** = Fabbricati (Gebäude) - **TF** = Beide Bereiche (sofern vom Endpunkt unterstützt)\n","example":"F"},"Comune":{"type":"object","properties":{"comune":{"type":"string"},"sezioni":{"type":"array","items":{"type":"string"}},"codice_catastale":{"type":"string"}}},"Richieste":{"type":"object","properties":{"id":{"type":"string"},"endpoint":{"type":"string"},"stato":{"type":"string"},"timestamp":{"type":"integer"},"owner":{"type":"string"}}},"Richiesta":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"endpoint":{"type":"string","enum":["elenco_immobili","prospetto_catastale","ricerca_persona_giuridica","ricerca_persona_fisica","ricerca_nazionale_pg","ricerca_nazionale_pf","indirizzo"]},"stato":{"type":"string"},"callback":{"$ref":"#/components/schemas/Callback"},"parametri":{"oneOf":[{"$ref":"#/components/schemas/ParametriElencoImmobili"},{"$ref":"#/components/schemas/ParametriProspettoCatastale"},{"$ref":"#/components/schemas/ParametriRicercaPersona"},{"$ref":"#/components/schemas/ParametriRicercaNazionale"},{"$ref":"#/components/schemas/ParametriIndirizzo"}]},"risultato":{"type":"object","nullable":true,"description":"In POST-Antworten immer null.\n"},"esito":{"type":"string"},"timestamp":{"type":"integer"},"owner":{"type":"string"}}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"ParametriElencoImmobili":{"type":"object","properties":{"tipo_catasto":{"$ref":"#/components/schemas/TipoCatasto"},"provincia":{"type":"string","description":"Province code (2 Buchstaben, z. B. **RM**, **GE**).","example":"RM"},"comune":{"type":"string","description":"Name der Gemeinde (z. B. **ROMA**).","example":"ROMA"},"sezione":{"type":"string","description":"Katasterabschnitt. **Nur für Gemeinden erforderlich, die über Abschnitte verfügen** (siehe `Territorio.sezioni`). Andernfalls leer lassen.\n","example":""},"sezione_urbana":{"type":"string","description":"Stadtteil. **Nicht erforderlich**. Nur angeben, falls bekannt; andernfalls leer lassen.\n","example":""},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Katasterblattnummer.","example":872},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Katasterparzellen-/Grundstücksnummer.","example":405}},"required":["tipo_catasto","provincia","comune","foglio","particella"]},"BodyPostElencoImmobili":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"},"tipo_catasto":{"$ref":"#/components/schemas/TipoCatasto"},"provincia":{"type":"string","description":"Province code (2 Buchstaben).","example":"RM"},"comune":{"type":"string","description":"Name der Gemeinde in Großbuchstaben.","example":"ROMA"},"sezione":{"type":"string","description":"Nur erforderlich, wenn die Gemeinde Abschnitte veröffentlicht.","example":""},"sezione_urbana":{"type":"string","description":"Nicht erforderlich; bitte nur angeben, falls vorhanden.","example":""},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Katasterblattnummer.","example":872},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Katasterparzellennummer.","example":405}},"required":["tipo_catasto","provincia","comune","foglio","particella"]},"ParametriProspettoCatastale":{"type":"object","properties":{"tipo_catasto":{"$ref":"#/components/schemas/TipoCatasto"},"provincia":{"type":"string","description":"Province code (2 Buchstaben).","example":"RM"},"comune":{"type":"string","description":"Name der Gemeinde in Großbuchstaben.","example":"ROMA"},"sezione":{"type":"string","description":"Nur für Gemeinden mit Ortsteilen erforderlich; ansonsten leer lassen.","example":""},"sezione_urbana":{"type":"string","description":"Nicht erforderlich; optional.","example":""},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Katasterblattnummer.","example":872},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Katasterparzellennummer.","example":405},"subalterno":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Kennung der Untereinheit (erforderlich für die detaillierte Objektbeschreibung).","example":48}},"required":["tipo_catasto","provincia","comune","foglio","particella"]},"BodyPostProspettoCatastale":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"},"tipo_catasto":{"$ref":"#/components/schemas/TipoCatasto"},"provincia":{"type":"string","description":"Province code (2 Buchstaben).","example":"RM"},"comune":{"type":"string","description":"Name der Gemeinde in Großbuchstaben.","example":"ROMA"},"sezione":{"type":"string","description":"Nur erforderlich, wenn die Gemeinde Abschnitte veröffentlicht.","example":""},"sezione_urbana":{"type":"string","description":"Nicht erforderlich; optional.","example":""},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Katasterblattnummer.","example":872},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Katasterparzellennummer.","example":405},"subalterno":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Kennung der Untereinheit; erforderlich, um eine einzelne Einheit (z. B. Wohnungen) anzusprechen.","example":48}},"required":["tipo_catasto","provincia","comune","foglio","particella"]},"ParametriRicercaPersona":{"type":"object","properties":{"cf_piva":{"type":"string","description":"Italienische Steuernummer (**CF**) oder Umsatzsteuer-Identifikationsnummer (**P.IVA**) der Person/des Unternehmens.","example":"12485671007"},"tipo_catasto":{"$ref":"#/components/schemas/TipoCatasto"},"provincia":{"type":"string","description":"Province-Code (2 Buchstaben). Erforderlich für die lokale Suche.","example":"RM"}},"required":["cf_piva","tipo_catasto","provincia"]},"BodyPostRicercaPersona":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"},"cf_piva":{"type":"string"},"tipo_catasto":{"type":"string","enum":["T","F","TF"]},"provincia":{"type":"string"}},"required":["cf_piva","tipo_catasto","provincia"]},"ParametriRicercaNazionale":{"type":"object","properties":{"cf_piva":{"type":"string","description":"Italienische Steuernummer (CF) oder Umsatzsteuer-Identifikationsnummer (P.IVA).","example":"12485671007"},"tipo_catasto":{"$ref":"#/components/schemas/TipoCatasto"}},"required":["cf_piva","tipo_catasto"]},"BodyPostRicercaNazionale":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"},"cf_piva":{"type":"string"},"tipo_catasto":{"type":"string","enum":["T","F","TF"]}},"required":["cf_piva","tipo_catasto"]},"ParametriIndirizzo":{"type":"object","properties":{"id_indirizzo":{"type":"string","description":"Vom Endpunkt für die Adresssuche zurückgegebene Adresskennung.","example":"MjUwNSMyMzYjVklBIERFTCBSSVZP"},"dal_civico":{"type":"string","description":"Ab der Hausnummer (einschließlich). Optional.","example":"2"},"al_civico":{"type":"string","description":"Bis zur Hausnummer (einschließlich). Optional.","example":"3"}},"required":["id_indirizzo"]},"BodyPostIndirizzo":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/Callback"},"id_indirizzo":{"type":"string"},"dal_civico":{"type":"string"},"al_civico":{"type":"string"}},"required":["id_indirizzo"]},"RisultatoElencoImmobiliFabbricati":{"type":"object","properties":{"immobili":{"type":"array","items":{"type":"object","properties":{"sezione_urbana":{"type":"string"},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"subalterno":{"type":"integer"},"indirizzo":{"type":"string"},"sezione":{"type":"string"},"zona_censuaria":{"type":"string"},"categoria":{"type":"string"},"classe":{"type":"string"},"consistenza":{"type":"string"},"rendita":{"type":"string"},"partita":{"type":"string"},"id_immobile":{"type":"string"}}}}}},"RisultatoElencoImmobiliTerreni":{"type":"object","properties":{"immobili":{"type":"array","items":{"type":"object","properties":{"sezione_urbana":{"type":"string"},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"subalterno":{"type":"integer"},"qualita":{"type":"string"},"classe":{"type":"string"},"ha":{"type":"string","description":"Hektar"},"are":{"type":"string","description":"Fläche: 100 Quadratmeter"},"ca":{"type":"string","description":"centiara: 1 Quadratmeter"},"reddito_dominicale":{"type":"string"},"reddito_agrario":{"type":"string"},"partita":{"type":"string"},"porzioni":{"oneOf":[{"type":"string"},{"type":"array","items":{"$ref":"#/components/schemas/Porzioni"}}]},"id_immobile":{"type":"string"}}}}}},"RisultatoProspettoCatastaleFabbricati":{"type":"object","properties":{"immobili":{"type":"array","items":{"type":"object","properties":{"sezione_urbana":{"type":"string"},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"subalterno":{"type":"integer"},"indirizzo":{"type":"string"},"sezione":{"type":"string"},"zona_censuaria":{"type":"string"},"categoria":{"type":"string"},"classe":{"type":"string"},"consistenza":{"type":"string"},"rendita":{"type":"string"},"partita":{"type":"string"},"id_immobile":{"type":"string"},"intestatari":{"type":"array","items":{"type":"object","properties":{"denominazione":{"type":"string"},"cf":{"type":"string"},"proprieta":{"type":"string"},"quota":{"type":"string"}}}}}}}}},"RisultatoProspettoCatastaleTerreni":{"type":"object","properties":{"immobili":{"type":"array","items":{"type":"object","properties":{"sezione_urbana":{"type":"string"},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"subalterno":{"type":"integer"},"qualita":{"type":"string"},"classe":{"type":"string"},"ha":{"type":"string"},"are":{"type":"string"},"ca":{"type":"string"},"reddito_dominicale":{"type":"string"},"reddito_agrario":{"type":"string"},"partita":{"type":"string"},"porzioni":{"oneOf":[{"type":"string"},{"type":"array","items":{"$ref":"#/components/schemas/Porzioni"}}]},"id_immobile":{"type":"string"},"intestatari":{"type":"array","items":{"type":"object","properties":{"denominazione":{"type":"string"},"cf":{"type":"string"},"proprieta":{"type":"string"},"quota":{"type":"string"}}}}}}}}},"Porzioni":{"type":"object","properties":{"porzione":{"type":"string"},"qualita":{"type":"string"},"classe":{"type":"string"},"ha":{"type":"string"},"are":{"type":"string"},"ca":{"type":"string"},"reddito_dominicale":{"type":"string"},"reddito_agrario":{"type":"string"}}},"RisultatoRicercaPersonaFisica":{"type":"object","properties":{"soggetti":{"type":"array","items":{"type":"object","properties":{"cognome":{"type":"string"},"nome":{"type":"string"},"data_nascita":{"type":"string"},"luogo_nascita":{"type":"string"},"sesso":{"type":"string"},"cf":{"type":"string"},"id_soggetto":{"type":"string"},"immobili":{"type":"array","items":{"type":"object","properties":{"catasto":{"type":"string"},"titolarita":{"type":"string"},"ubicazione":{"type":"string"},"comune":{"type":"string"},"provincia":{"type":"string"},"codice_catastale":{"type":"string"},"sezione":{"type":"string"},"sezione_urbana":{"type":"string"},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"subalterno":{"type":"integer"},"classamento":{"type":"string"},"classe":{"type":"string"},"consistenza":{"type":"string"},"rendita":{"type":"string"},"id_immobile":{"type":"string"}}}}}}}}},"RisultatoRicercaPersonaGiuridica":{"type":"object","properties":{"soggetti":{"type":"array","items":{"type":"object","properties":{"denominazione":{"type":"string"},"sede":{"type":"string"},"cf":{"type":"string"},"id_soggetto":{"type":"string"},"immobili":{"type":"array","items":{"type":"object","properties":{"catasto":{"type":"string"},"titolarita":{"type":"string"},"ubicazione":{"type":"string"},"comune":{"type":"string"},"provincia":{"type":"string"},"codice_catastale":{"type":"string"},"sezione":{"type":"string"},"sezione_urbana":{"type":"string"},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"subalterno":{"type":"integer"},"classamento":{"type":"string"},"classe":{"type":"string"},"consistenza":{"type":"string"},"rendita":{"type":"string"},"id_immobile":{"type":"string"}}}}}}}}},"RisultatoRicercaNazionalePF":{"type":"object","properties":{"soggetti":{"type":"array","items":{"type":"object","properties":{"cognome":{"type":"string"},"nome":{"type":"string"},"data_nascita":{"type":"string"},"luogo_nascita":{"type":"string"},"sesso":{"type":"string"},"cf":{"type":"string"},"id_soggetto":{"type":"string"},"catasti":{"type":"array","items":{"type":"object","properties":{"citta":{"type":"string"},"fabbricati":{"type":"integer"},"terreni":{"type":"integer"},"provincia":{"type":"string"},"comuni":{"type":"array","items":{"type":"object","properties":{"comune":{"type":"string"},"fabbricati":{"type":"integer"},"terreni":{"type":"integer"}}}}}}}}}}}},"RisultatoRicercaNazionalePG":{"type":"object","properties":{"soggetti":{"type":"array","items":{"type":"object","properties":{"denominazione":{"type":"string"},"sede":{"type":"string"},"cf":{"type":"string"},"id_soggetto":{"type":"string"},"catasti":{"type":"array","items":{"type":"object","properties":{"citta":{"type":"string"},"fabbricati":{"type":"integer"},"terreni":{"type":"integer"},"provincia":{"type":"string"},"comuni":{"type":"array","items":{"type":"object","properties":{"comune":{"type":"string"},"fabbricati":{"type":"integer"},"terreni":{"type":"integer"}}}}}}}}}}}},"RisultatoIndirizzo":{"type":"object","properties":{"immobili":{"type":"array","items":{"type":"object","properties":{"sezione_urbana":{"type":"string"},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"subalterno":{"type":"integer"},"indirizzo":{"type":"string"},"zona_censuaria":{"type":"string"},"categoria":{"type":"string"},"classe":{"type":"string"},"consistenza":{"type":"string"},"rendita":{"type":"string"},"id_immobile":{"type":"string"}}}}}},"Callback":{"description":"Dies ist unser standardisiertes OpenAPI-Callback-System. Es ermöglicht die Konfiguration von Parametern für den Empfang von Benachrichtigungen über Statusaktualisierungen asynchroner Anfragen an diesen Endpunkt.\n","oneOf":[{"type":"object","required":["url"],"properties":{"method":{"type":"string","description":"Geben Sie die Callback-Methode an. Bei der Einstellung „POST“ wird eine standardmäßige HTTP-POST-Anfrage initiiert, wobei der Content-Type-Header auf „application/x-www-form-urlencoded“ gesetzt ist. Die JSON-Daten werden in ein Schlüssel-Wert-Paar namens „data“ (anpassbar über den Parameter „field“) im Anfragetext kodiert. Ist die Methode auf „JSON“ gesetzt, wird eine direkte HTTP-POST-Anfrage gestellt, wobei der Content-Type-Header auf „application/json“ gesetzt ist. Die JSON-Rohdaten werden ohne jegliche Kodierung direkt in den Anfragetext eingefügt.\n","enum":["POST","JSON"],"default":"JSON"},"field":{"type":"string","description":"Dieser Parameter funktioniert in Verbindung mit dem Parameter „method“, der auf „POST“ gesetzt ist. Wenn er als Zeichenfolge angegeben wird, legt er den Namen des Parameters fest, der in der POST-Anfrage gesendet wird.\n","example":"data","default":"data"},"url":{"type":"string","format":"uri","description":"In diesen Parameter muss eine gültige URL eingegeben werden, die POST-Anfragen verarbeiten kann. Bei Endpunkten, die eine Authentifizierung erfordern, kann der Parameter „headers“ verwendet werden, um „basic auth“ oder „bearer auth“ anzugeben. Das maximale Timeout beträgt 30 Sekunden. Wenn „retry“ gesetzt ist, führt das System bis zu „retry“ Mal einen erneuten Versuch durch, bis ein Statuscode 200 empfangen wird.\n","example":"https://www.mysite.com/myEndpoint"},"retry":{"type":"integer","description":"Die maximale Anzahl der Versuche wird durch den Parameter „retry“ festgelegt. Wird die maximale Anzahl der Versuche erreicht, ohne dass ein erfolgreicher Statuscode (z. B. 200 OK) zurückgegeben wird, gilt die Anfrage als endgültig fehlgeschlagen. Oft wird zwischen den Versuchen ein Zeitintervall eingefügt, um eine Überlastung des Servers zu vermeiden. Dieses Intervall kann sich mit jedem Versuch exponentiell verlängern, um die Auswirkungen auf einen überlasteten Server zu verringern. Der Parameter „retry“ ist so konfiguriert, dass die Anfrage nur bei bestimmten Statuscodes erneut versucht wird, typischerweise bei solchen, die auf vorübergehende Fehler (z. B. 502, 503) oder Netzwerkprobleme hinweisen.\n","example":3,"maximum":5,"minimum":0,"default":0},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"Eine Sammlung von HTTP-Headern, die mit der Anfrage gesendet werden sollen. Jeder Header wird als Schlüssel-Wert-Paar definiert. Header können für verschiedene Zwecke verwendet werden, darunter Authentifizierung, Inhaltsaushandlung und benutzerdefinierte Metadaten.\n","example":{"session_id":"9834r5fh589494"}},"custom":{"type":"object","description":"Dieses Objekt kann mit beliebigen zusätzlichen Daten gefüllt werden, die Sie in die Callback-Antwort aufnehmen möchten. Auf diese Daten können Sie über den Parameter „custom“ der Callback-Funktion zugreifen. Auf diese Weise können Sie alle relevanten Informationen speichern und abrufen, die Sie für Ihre Anwendung benötigen.\n","example":{"my_custom_id":"123456789"}}}},{"type":"object","description":"Geben Sie an, über welche Methode Sie die Daten per Callback erhalten möchten; standardmäßig ist dies POST.","properties":{"method":{"type":"string","description":"Geben Sie an, über welche Methode Sie die Daten per Callback erhalten möchten; standardmäßig ist dies POST.","enum":["POST","JSON"]},"field":{"type":"string","description":"Name des Feldes, das die Rückgabedaten des Callbacks enthält"},"url":{"type":"string","description":"URL, unter der der Callback-Aufruf erfolgt","example":"https://www.mysite.com/myEndpoint"},"data":{"type":"object","description":"Dieses Feld können Sie nach Belieben mit zusätzlichen Daten ausfüllen, die Sie später beim Rückruf verwenden können."}}}]},"BodyPostRicercaIndirizzo":{"type":"object","properties":{"provincia":{"type":"string"},"comune":{"type":"string"},"sezione":{"type":"string"},"indirizzo":{"type":"string"},"callback":{"$ref":"#/components/schemas/Callback"}},"required":["provincia","comune","indirizzo"]},"RispostaPostIndirizzo":{"type":"object","properties":{"data":{"type":"object","properties":{"endpoint":{"type":"string"},"stato":{"type":"string"},"callback":{"$ref":"#/components/schemas/Callback"},"parametri":{"type":"object","properties":{"provincia":{"type":"string"},"comune":{"type":"string"},"sezione":{"type":"string"},"indirizzo":{"type":"string"}}},"risultato":{"type":"object","nullable":true,"description":"In POST-Antworten immer null.\n"},"esito":{"type":"string","nullable":true},"timestamp":{"type":"integer"},"owner":{"type":"string"},"id":{"type":"string"}}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"RispostaPostRichiesta":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"endpoint":{"type":"string","enum":["elenco_immobili","prospetto_catastale","ricerca_persona_giuridica","ricerca_persona_fisica","ricerca_nazionale_pg","ricerca_nazionale_pf","indirizzo"]},"stato":{"type":"string"},"callback":{"$ref":"#/components/schemas/Callback"},"parametri":{"oneOf":[{"$ref":"#/components/schemas/ParametriElencoImmobili"},{"$ref":"#/components/schemas/ParametriProspettoCatastale"},{"$ref":"#/components/schemas/ParametriRicercaPersona"},{"$ref":"#/components/schemas/ParametriRicercaNazionale"},{"$ref":"#/components/schemas/ParametriIndirizzo"}]},"risultato":{"oneOf":[{"$ref":"#/components/schemas/RisultatoElencoImmobiliFabbricati"},{"$ref":"#/components/schemas/RisultatoElencoImmobiliTerreni"},{"$ref":"#/components/schemas/RisultatoProspettoCatastaleFabbricati"},{"$ref":"#/components/schemas/RisultatoProspettoCatastaleTerreni"},{"$ref":"#/components/schemas/RisultatoRicercaPersonaFisica"},{"$ref":"#/components/schemas/RisultatoRicercaPersonaGiuridica"},{"$ref":"#/components/schemas/RisultatoRicercaNazionalePF"},{"$ref":"#/components/schemas/RisultatoRicercaNazionalePG"},{"$ref":"#/components/schemas/RisultatoIndirizzo"}]},"esito":{"type":"string"},"timestamp":{"type":"integer"},"owner":{"type":"string"}}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"RispostaSincronaIndirizzi":{"type":"object","properties":{"data":{"type":"object","properties":{"indirizzi":{"type":"array","items":{"type":"object","properties":{"id_indirizzo":{"type":"string"},"indirizzo":{"type":"string"}}}}}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"RisultatoListaIndirizzi":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"endpoint":{"type":"string"},"indirizzo":{"type":"string"},"stato":{"type":"string"},"timestamp":{"type":"integer"},"owner":{"type":"string"}}}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"RisultatoRichiestaIndirizzo":{"type":"object","properties":{"data":{"type":"object","properties":{"endpoint":{"type":"string"},"stato":{"type":"string"},"callback":{"$ref":"#/components/schemas/Callback"},"parametri":{"type":"object","properties":{"provincia":{"type":"string"},"comune":{"type":"string"},"sezione":{"type":"string"},"indirizzo":{"type":"string"}}},"risultato":{"type":"object","properties":{"indirizzi":{"type":"array","items":{"type":"object","properties":{"id_indirizzo":{"type":"string"},"indirizzo":{"type":"string"}}}}}},"esito":{"type":"string"},"timestamp":{"type":"integer"},"owner":{"type":"string"},"id":{"type":"string"}}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"Visure":{"type":"object","properties":{"id":{"type":"string"},"entita":{"type":"string","enum":["immobile","soggetto"]},"stato":{"type":"string","enum":["in_erogazione","evasa"]},"timestamp":{"type":"integer"},"owner":{"type":"string"}}},"Visura":{"type":"object","properties":{"id":{"type":"string"},"entita":{"type":"string","enum":["immobile","soggetto"]},"stato":{"type":"string","enum":["in_erogazione","in_lavorazione","evasa"]},"callback":{"$ref":"#/components/schemas/Callback"},"parametri":{"oneOf":[{"$ref":"#/components/schemas/ParametriVisuraImmobile"},{"$ref":"#/components/schemas/ParametriVisuraSoggetto"}]},"tipo_visura":{"type":"string","enum":["ordinaria","storica"]},"richiedente":{"type":"string"},"documento":{"type":"string"},"esito":{"type":"string"},"timestamp":{"type":"integer"},"owner":{"type":"string"}}},"EstrattoMappa":{"type":"object","properties":{"id":{"type":"string"},"endpoint":{"type":"string"},"stato":{"type":"string","enum":["in_erogazione","in_lavorazione","evasa"]},"callback":{"$ref":"#/components/schemas/Callback"},"parametri":{"$ref":"#/components/schemas/ParametriEstrattoMappa"},"documento":{"type":"string"},"esito":{"type":"string"},"timestamp":{"type":"integer"},"owner":{"type":"string"}}},"ElaboratoPlanimetrico":{"type":"object","properties":{"id":{"type":"string"},"endpoint":{"type":"string"},"stato":{"type":"string","enum":["in_erogazione","in_lavorazione","evasa"]},"callback":{"$ref":"#/components/schemas/Callback"},"parametri":{"$ref":"#/components/schemas/ParametriElaboratoPlanimetrico"},"documento":{"type":"string"},"esito":{"type":"string"},"timestamp":{"type":"integer"},"owner":{"type":"string"}}},"ParametriVisuraImmobile":{"type":"object","properties":{"id_immobile":{"type":"string"},"tipo_catasto":{"type":"string","enum":["T","F"]},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"subalterno":{"type":"integer"},"comune":{"type":"string"},"sezione":{"type":"string"},"sezione_urbana":{"type":"string"},"provincia":{"type":"string"}}},"ParametriVisuraSoggetto":{"type":"object","properties":{"id_soggetto":{"type":"string"},"tipo_catasto":{"type":"string","enum":["T","F","TF"]},"cf_piva":{"type":"string"},"provincia":{"type":"string"}}},"ParametriEstrattoMappa":{"type":"object","properties":{"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"comune":{"type":"string"},"sezione":{"type":"string","nullable":true},"provincia":{"type":"string"}}},"ParametriElaboratoPlanimetrico":{"type":"object","properties":{"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"sezione_urbana":{"oneOf":[{"type":"string"},{"type":"integer"}],"nullable":true},"comune":{"type":"string"},"sezione":{"type":"string","nullable":true},"provincia":{"type":"string"}}},"BodyVisuraImmobile":{"oneOf":[{"$ref":"#/components/schemas/IdImmobile"},{"$ref":"#/components/schemas/NoIdImmobile"}]},"BodyVisuraSoggetto":{"oneOf":[{"$ref":"#/components/schemas/IdSoggetto"},{"$ref":"#/components/schemas/NoIdSoggetto"}]},"IdImmobile":{"type":"object","properties":{"entita":{"type":"string","enum":["immobile"]},"id_immobile":{"type":"string"},"tipo_visura":{"type":"string","enum":["ordinaria","storica"]},"tipo_dettaglio":{"type":"string","enum":["sintetica","analitica"]},"tipo_formato":{"type":"string","enum":["xml","json","pdf"]},"richiedente":{"type":"string"},"callback":{"$ref":"#/components/schemas/Callback"}},"required":["entita","id_immobile","tipo_visura"]},"NoIdImmobile":{"type":"object","properties":{"entita":{"type":"string","enum":["immobile"]},"tipo_catasto":{"type":"string","enum":["T","F"]},"tipo_dettaglio":{"type":"string","enum":["sintetica","analitica"]},"tipo_formato":{"type":"string","enum":["xml","json","pdf"]},"provincia":{"type":"string"},"comune":{"type":"string"},"sezione":{"type":"string"},"sezione_urbana":{"type":"string"},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}]},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}]},"subalterno":{"oneOf":[{"type":"string"},{"type":"integer"}]},"tipo_visura":{"type":"string","enum":["ordinaria","storica"]},"richiedente":{"type":"string"},"callback":{"$ref":"#/components/schemas/Callback"}},"required":["entita","tipo_catasto","provincia","comune","foglio","particella","tipo_visura"]},"IdSoggetto":{"type":"object","properties":{"entita":{"type":"string","enum":["soggetto"]},"id_soggetto":{"type":"string"},"tipo_catasto":{"type":"string","enum":["T","F","TF"],"default":"TF"},"provincia":{"type":"string"},"tipo_visura":{"type":"string","enum":["ordinaria","storica"]},"tipo_dettaglio":{"type":"string","enum":["sintetica","analitica"]},"tipo_formato":{"type":"string","enum":["xml","json","pdf"]},"richiedente":{"type":"string"},"callback":{"$ref":"#/components/schemas/Callback"}},"required":["entita","id_soggetto","tipo_visura","tipo_catasto"]},"NoIdSoggetto":{"type":"object","properties":{"entita":{"type":"string","enum":["soggetto"]},"cf_piva":{"type":"string"},"tipo_catasto":{"type":"string","enum":["T","F","TF"]},"tipo_dettaglio":{"type":"string","enum":["sintetica","analitica"]},"provincia":{"type":"string"},"tipo_visura":{"type":"string","enum":["ordinaria","storica"]},"tipo_formato":{"type":"string","enum":["xml","json","pdf"]},"richiedente":{"type":"string"},"callback":{"$ref":"#/components/schemas/Callback"}},"required":["entita","cf_piva","provincia","tipo_visura","tipo_catasto"]},"BodyEstrattoMappa":{"type":"object","properties":{"provincia":{"type":"string","example":"RM"},"comune":{"type":"string","example":"ROMA"},"sezione":{"type":"string"},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}],"example":1},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}],"example":1},"callback":{"$ref":"#/components/schemas/Callback"}},"required":["provincia","comune","foglio","particella"]},"BodyElaboratoPlanimetrico":{"type":"object","properties":{"provincia":{"type":"string","example":"RM"},"comune":{"type":"string","example":"ROMA"},"sezione":{"type":"string"},"sezione_urbana":{"type":"string"},"foglio":{"oneOf":[{"type":"string"},{"type":"integer"}],"example":1},"particella":{"oneOf":[{"type":"string"},{"type":"integer"}],"example":1},"callback":{"$ref":"#/components/schemas/Callback"}},"required":["provincia","comune","foglio","particella"]},"MonitorRequest":{"type":"object","properties":{"tipo_monitoraggio":{"type":"string","description":"Art der Überwachungsanfrage","enum":["prospetto_catastale","ricerca_persona_fisica","ricerca_persona_giuridica","ricerca_nazionale_pf","ricerca_nazionale_pg"]},"rinnovo_automatico":{"type":"boolean","description":"Kennzeichen für automatische Verlängerung. Wird dieses Kennzeichen weggelassen, gilt der Standardwert „true“.","default":true,"example":true},"parametri":{"description":"für die Überwachungsanfrage verwendete Parameter","oneOf":[{"$ref":"#/components/schemas/ParametriProspettoCatastale"},{"$ref":"#/components/schemas/ParametriRicercaPersona"},{"$ref":"#/components/schemas/ParametriRicercaNazionale"}]},"esito":{"type":"string","nullable":true},"data_ultima_verifica":{"type":"string","description":"Datum der letzten Überprüfung","format":"date","nullable":true},"data_prossima_verifica":{"type":"string","description":"Datum der nächsten Überprüfung","format":"date"},"data_scadenza":{"type":"string","description":"Überwachung des Verfallsdatums","format":"date"},"id":{"type":"string","description":"Anfrage-ID"}}},"MonitorPayload":{"oneOf":[{"$ref":"#/components/schemas/BodyPostMonitoraggioProspettoCatastale"},{"$ref":"#/components/schemas/BodyPostMonitoraggioRicercaPersona"},{"$ref":"#/components/schemas/BodyPostMonitoraggioRicercaNazionale"}]},"BodyPostMonitoraggioProspettoCatastale":{"allOf":[{"$ref":"#/components/schemas/BodyPostProspettoCatastale"},{"type":"object","properties":{"tipo_monitoraggio":{"type":"string","enum":["prospetto_catastale"],"description":"Art der Überwachung."},"campi_monitorati":{"type":"array","description":"Zu überwachende Felder. Wird dieser Parameter weggelassen, werden alle Felder überwacht. Verwenden Sie „all“, um alle Felder zu überwachen. Für „tipo_catasto F“ sind folgende Felder zulässig: „zona_censuaria“, „categoria“, „classe“, „consistenza“, „rendita“, „qualita“, „partita“, „intestatari“. Für „tipo_catasto T“ sind folgende Felder zulässig: „zona_censuaria“, „classe“, „consistenza“, „qualita“, „ha“, „are“, „ca“, „reddito_dominicale“, „reddito_agrario“, „partita“, „intestatari“.","items":{"type":"string","enum":["all","zona_censuaria","categoria","classe","consistenza","rendita","qualita","partita","intestatari","ha","are","ca","reddito_dominicale","reddito_agrario"]},"example":["rendita","classe","intestatari"]},"rinnovo_automatico":{"type":"boolean","description":"Kennzeichen für automatische Verlängerung. Wird dieses Feld weggelassen, gilt der Standardwert „true“.","default":true,"example":true}},"required":["tipo_monitoraggio","subalterno"]}]},"BodyPostMonitoraggioRicercaPersona":{"allOf":[{"$ref":"#/components/schemas/BodyPostRicercaPersona"},{"type":"object","properties":{"tipo_monitoraggio":{"type":"string","enum":["ricerca_persona"],"description":"Überwachungsart. Der Dienst ordnet die Anfrage anhand von „cf_piva“ entweder als „ricerca_persona_fisica“ oder als „ricerca_persona_giuridica“ ein."},"campi_monitorati":{"type":"array","description":"Optional. Bei dieser Überwachungsart wird der Wert immer als [\"all\"] gespeichert.","items":{"type":"string","enum":["all"]},"default":["all"],"example":["all"]},"rinnovo_automatico":{"type":"boolean","description":"Kennzeichen für automatische Verlängerung. Wird dieses Feld weggelassen, gilt der Standardwert „true“.","default":true,"example":true}},"required":["tipo_monitoraggio"]}]},"BodyPostMonitoraggioRicercaNazionale":{"allOf":[{"$ref":"#/components/schemas/BodyPostRicercaNazionale"},{"type":"object","properties":{"tipo_monitoraggio":{"type":"string","enum":["ricerca_nazionale"],"description":"Überwachungsart. Der Dienst ordnet die Anfrage anhand von „cf_piva“ entweder als „ricerca_nazionale_pf“ oder als „ricerca_nazionale_pg“ zu."},"campi_monitorati":{"type":"array","description":"Optional. Bei dieser Überwachungsart wird der Wert immer als [\"all\"] gespeichert.","items":{"type":"string","enum":["all"]},"default":["all"],"example":["all"]},"rinnovo_automatico":{"type":"boolean","description":"Kennzeichen für automatische Verlängerung. Wird dieses Feld weggelassen, gilt der Standardwert „true“.","default":true,"example":true}},"required":["tipo_monitoraggio"]}]}}},"paths":{"/territorio":{"get":{"tags":["Territorio"],"summary":"Provinzen auflisten","description":"Gibt alle italienischen Provinzen zurück. Wird **tipo_catasto** weggelassen, wird standardmäßig der Datensatz „Gebäude“ (**F**) verwendet.","parameters":[{"name":"tipo_catasto","in":"query","required":false,"description":"**F** = Gebäude (Standard), **T** = Grundstück.\n","schema":{"type":"string","enum":["T","F"],"default":"F"},"example":"F"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"provincia":{"type":"string","description":"Zweistelliger Kürzel der Provinz (z. B. **RM**, **GE**).","example":"GE"},"nome_provincia":{"type":"string","example":"GENOVA"},"id":{"type":"string","description":"Interne Kennung für den Eintrag zur province."}}}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"provincia":"GE","nome_provincia":"GENOVA","id":"60c9cc8f24a66c54f04c6df2"},{"provincia":"AV","nome_provincia":"AVELLINO","id":"60c9d49517d4af446c1af7b2"}],"success":true,"message":"","error":null}}}}}}},"/territorio/{provincia_or_nome_provincia_or_id}":{"get":{"tags":["Territorio"],"summary":"Angaben zur province","description":"Gibt die ausgewählte province mit ihren Gemeinden zurück. Wird **tipo_catasto** weggelassen, wird standardmäßig der Datensatz „Gebäude“ (**F**) verwendet.","parameters":[{"name":"provincia_or_nome_provincia_or_id","in":"path","required":true,"description":"Province code (**z. B. TR**), vollständiger Name der Provinz (**z. B. TERNI**) oder interne **ID**.","schema":{"type":"string"},"example":"TR"},{"name":"tipo_catasto","in":"query","required":false,"description":"**F** = Gebäude (Standard), **T** = Grundstück.\n","schema":{"type":"string","enum":["T","F"],"default":"F"},"example":"F"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"provincia":{"type":"string"},"nome_provincia":{"type":"string"},"comuni":{"type":"array","items":{"$ref":"#/components/schemas/Comune"}},"id":{"type":"string"}}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"provincia":"TR","nome_provincia":"TERNI","comuni":[{"comune":"ACQUASPARTA","sezioni":null,"codice_catastale":"A045"},{"comune":"TERNI","sezioni":null,"codice_catastale":"L117"}],"id":"60ca2d837e1f2f6f3a2bfd42"},"success":true,"message":"","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no province matches this id: ","error":201,"data":null}}}}}}},"/territorio/{provincia_or_nome_provincia_or_id}/{comune}":{"get":{"tags":["Territorio"],"summary":"Gemeindedetails","description":"Gibt die ausgewählte Gemeinde innerhalb der angegebenen province zurück. Wird **tipo_catasto** weggelassen, wird standardmäßig der Datensatz „Gebäude“ (**F**) verwendet.","parameters":[{"name":"provincia_or_nome_provincia_or_id","in":"path","required":true,"description":"Province code (**z. B. TR**), vollständiger Name der Provinz (**z. B. TERNI**) oder interne **ID**.","schema":{"type":"string"},"example":"TR"},{"name":"comune","in":"path","required":true,"description":"Von **Territorio** zurückgegebener Name der Gemeinde.","schema":{"type":"string"},"example":"TERNI"},{"name":"tipo_catasto","in":"query","required":false,"description":"**F** = Gebäude (Standard), **T** = Grundstück.\n","schema":{"type":"string","enum":["T","F"],"default":"F"},"example":"F"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"provincia":{"type":"string"},"nome_provincia":{"type":"string"},"comuni":{"type":"array","items":{"$ref":"#/components/schemas/Comune"}},"id":{"type":"string"}}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"provincia":"TR","nome_provincia":"TERNI","comuni":[{"comune":"TERNI","sezioni":null,"codice_catastale":"L117"}],"id":"60ca2d837e1f2f6f3a2bfd42"},"success":true,"message":"","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no result matches this id: TZ and this comune: TZERI","error":200,"data":null}}}}}}},"/territorio/conservatorie":{"get":{"tags":["Territorio"],"summary":"Liste der Grundbuchämter","description":"Gibt die Liste aller italienischen Grundbuchämter (Conservatorie) zurück.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"conservatoria":{"type":"string","description":"Name des Grundbuchamtes","example":"AGRIGENTO"},"id":{"type":"string","description":"Interne Kennung","example":"62d02bafdb0c404a8530bc84"}}}},"success":{"type":"boolean","example":true},"message":{"type":"string","example":""},"error":{"type":"integer","nullable":true,"example":null}}},"example":{"data":[{"conservatoria":"ACQUI TERME","id":"62d02bafdb0c404a8530bc83"},{"conservatoria":"AGRIGENTO","id":"62d02bafdb0c404a8530bc84"}],"success":true,"message":"","error":null}}}}}}},"/territorio/conservatorie/{conservatoria_or_id}":{"get":{"tags":["Territorio"],"summary":"Katasterämter, Gemeinden und Katasterbezirke","description":"Gibt die Gemeinden zurück, die einem bestimmten italienischen Grundbuchamt (Conservatoria) zugeordnet sind. Wird der optionale Abfrageparameter „**comune**“ angegeben, werden\n die Einträge für die ausgewählte Gemeinde innerhalb desselben Grundbuchamts zurückgegeben.","parameters":[{"in":"path","name":"conservatoria_or_id","required":true,"schema":{"type":"string"},"description":"Grundbuchamt","example":"agrigento"},{"in":"query","name":"comune","required":false,"schema":{"type":"string"},"description":"Name der Gemeinde. Sofern angegeben, werden Details zu dieser Gemeinde angezeigt.","example":"/territorio/conservatorie/agrigento?comune=agrigento"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"nullable":true,"oneOf":[{"type":"array","items":{"type":"object","properties":{"conservatoria":{"type":"string","example":"AGRIGENTO"},"comuni":{"type":"array","items":{"type":"object","properties":{"comune":{"type":"string","example":"AGRIGENTO"},"codice_catastale":{"type":"string","example":"A052"}}}}}}},{"type":"object","properties":{"conservatoria":{"type":"string","example":"AGRIGENTO"},"comuni":{"type":"array","items":{"type":"object","properties":{"comune":{"type":"string","example":"AGRIGENTO"},"catasto":{"type":"object","properties":{"terreni":{"type":"object","properties":{"sezioni":{"type":"array","nullable":true,"description":"Liste der Katasterabschnitte.","items":{"type":"string","example":"A"}}}},"fabbricati":{"type":"object","properties":{"sezioni":{"type":"array","nullable":true,"description":"Liste der Katasterabschnitte.","items":{"type":"string","example":"A"}}}}}}}}}}}]},"success":{"type":"boolean","example":true},"message":{"type":"string","example":""},"error":{"type":"integer","nullable":true,"example":null}}},"examples":{"municipalities_list":{"summary":"Liste der Gemeinden für ein Konservatorium","value":{"data":[{"conservatoria":"AGRIGENTO","comuni":[{"comune":"AGRIGENTO","codice_catastale":"A089"},{"comune":"ALESSANDRIA DELLA ROCCA","codice_catastale":"A181"},{"comune":"ARAGONA","codice_catastale":"A351"}]}],"success":true,"message":"","error":null}},"municipality_details":{"summary":"Angaben zur Gemeinde mit Katasterabschnitt","value":{"data":{"conservatoria":"AGRIGENTO","comuni":[{"comune":"AGRIGENTO","catasto":{"terreni":{"sezioni":["A","B"]},"fabbricati":{"sezioni":null}}}]},"success":true,"message":"","error":null}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"examples":{"conservatoria_not_found":{"summary":"Unbekannte Konservatorien","value":{"success":false,"message":"no result matches","error":348,"data":null}},"comune_not_found":{"summary":"Gemeinde unbekannt für die ausgewählten Konservatorien","value":{"success":false,"message":"no result matches this comune: {wrong comune}","error":349,"data":null}}}}}}}}},"/richiesta/{endpoint}/":{"post":{"tags":["Richiesta"],"summary":"Erstellt eine Anfrage","description":"Mit dieser Methode können Sie eine Anfrage erstellen, um Informationen zu Objekten und Grundstücken im italienischen Kataster zu erhalten.\n\nIn einigen Fällen kann der Dienst **synchron** arbeiten und die **Antwort sofort** zurückgeben.\n\n• **elenco_immobili** – gibt detaillierte Informationen zu jeder Immobilie (immobile) innerhalb des angegebenen „foglio“ und der angegebenen „particella“ zurück. Hinweis: Das Feld „sezione“ ist nur in Gemeinden erforderlich, die über Abschnitte verfügen; „sezione_urbana“ ist niemals erforderlich.\n\n• **prospetto_catastale** – gibt detaillierte Informationen zu jeder Immobilie (immobile) innerhalb des angegebenen „foglio“, der „particella“ und des „subalterno“ zurück, einschließlich Angaben zu den Eigentümern (intestatari). Hinweis: Das Feld „sezione“ ist nur in Gemeinden erforderlich, die über Sektionen verfügen; „sezione_urbana“ ist niemals erforderlich.\n\n\n• **ricerca_persona** – gibt grundlegende Informationen über den Eigentümer sowie die Liste der Immobilien zurück, die dieser Person oder juristischen Person innerhalb der angegebenen province gehören. In einigen Fällen wird die Liste der Immobilien möglicherweise nicht zurückgegeben; in diesem Fall wird die Person möglicherweise mit einem leeren „immobili“-Array zurückgegeben, oder die Antwort liefert keine Ergebnisse und enthält eine Meldung, dass die Suche zu viele Ergebnisse liefert.\n\n • **ricerca_nazionale** – Durchsucht das gesamte Staatsgebiet nach den Immobilien, die sich im Besitz einer Person befinden.\n  Das Ergebnis liefert eine aggregierte Übersicht nach province und Gemeinde, aus der die Anzahl der im Besitz befindlichen Gebäude und Grundstücke hervorgeht, ohne dass vollständige Immobiliendetails zurückgegeben werden.  \n\n• **indirizzo** – Gibt die Liste der Immobilien (mit vollständigen Details) zurück, die mit einer bestimmten Adresskennung (**id_indirizzo**) verknüpft sind, die über POST/indirizzo (**asynchron**) oder GET /indirizzo (**synchron**) abgerufen wurde.\nIn einigen Fällen ist es erforderlich, zusätzlich zur Adresse auch die Hausnummer anzugeben, damit gültige Ergebnisse zurückgegeben werden. Fehlt die Hausnummer, kann das System der angegebenen Adresse unter Umständen keine Immobilie korrekt zuordnen.\n \n","parameters":[{"name":"endpoint","in":"path","description":"Art der angeforderten Dienstleistung","required":true,"schema":{"enum":["elenco_immobili","prospetto_catastale","ricerca_persona","ricerca_nazionale","indirizzo"],"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/BodyPostElencoImmobili"},{"$ref":"#/components/schemas/BodyPostProspettoCatastale"},{"$ref":"#/components/schemas/BodyPostRicercaPersona"},{"$ref":"#/components/schemas/BodyPostRicercaNazionale"},{"$ref":"#/components/schemas/BodyPostIndirizzo"}]},"examples":{"elenco_immobili":{"value":{"tipo_catasto":"F","provincia":"RM","comune":"ROMA","sezione":"","foglio":"872","particella":"405"}},"prospetto_catastale":{"value":{"tipo_catasto":"F","provincia":"RM","comune":"ROMA","sezione":"","foglio":"872","particella":"405","subalterno":"48"}},"ricerca_persona (giuridica)":{"value":{"cf_piva":"12485671007","tipo_catasto":"F","provincia":"RM"}},"ricerca_persona (fisica)":{"value":{"cf_piva":"RSSMRA80C24H501J","tipo_catasto":"F","provincia":"RM"}},"ricerca_nazionale (giuridica)":{"value":{"cf_piva":"12485671007","tipo_catasto":"TF"}},"ricerca_nazionale (fisica)":{"value":{"cf_piva":"RSSMRA80C24H501J","tipo_catasto":"TF"}},"indirizzo":{"value":{"id_indirizzo":"MjUwNSMjVklBIERFTCBSSVZPQFRFUk5JIFRlcnJpdG9yaW8tVFJATDExNyNURVJOSSMwIzBA","dal_civico":"2","al_civico":"3"}}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RispostaPostRichiesta"},"custom":{"type":"object","nullable":true,"additionalProperties":true}}},"example":{"data":{"endpoint":"ricerca_nazionale_pg","stato":"evasa","callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"parametri":{"cf_piva":"12485671007","tipo_catasto":"TF","provincia":"NAZIONALE-IT"},"risultato":{"soggetti":[{"denominazione":"OPENAPI SRL","sede":"ROMA (RM)","cf":"12485671007","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","catasti":[{"citta":"ROMA","fabbricati":1,"terreni":0,"provincia":"RM","comuni":[{"comune":"ROMA","fabbricati":1,"terreni":0}]}]}]},"esito":"OK","timestamp":1625232029,"owner":"test@email.it","id":"60e580f1617b512c3450d3c7"},"custom":null}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Richiesta"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"elenco_immobili":{"value":{"data":{"endpoint":"elenco_immobili","stato":"in_erogazione","callback":false,"parametri":{"tipo_catasto":"F","provincia":"ROMA Territorio-RM","comune":"H501#ROMA#4#0","sezione":null,"sezione_urbana":null,"foglio":872,"particella":405},"risultato":null,"esito":null,"timestamp":1625232029,"owner":"test@email.it","id":"60e581c58138e80d804dad20"},"success":true,"message":"","error":null}},"prospetto_catastale":{"value":{"data":{"endpoint":"prospetto_catastale","stato":"in_erogazione","callback":false,"parametri":{"tipo_catasto":"F","provincia":"ROMA Territorio-RM","comune":"H501#ROMA#4#0","sezione":null,"sezione_urbana":null,"foglio":872,"particella":405,"subalterno":48},"risultato":null,"esito":null,"timestamp":1625232029,"owner":"test@email.it","id":"60e581c58138e80d804dad20"},"success":true,"message":"","error":null}},"ricerca_persona (giuridica)":{"value":{"data":{"endpoint":"ricerca_persona_giuridica","stato":"in_erogazione","callback":false,"parametri":{"cf_piva":"12485671007","tipo_catasto":"F","provincia":"ROMA Territorio-RM"},"risultato":null,"esito":null,"timestamp":1625232029,"owner":"test@email.it","id":"60e581c58138e80d804dad20"},"success":true,"message":"","error":null}},"ricerca_persona (fisica)":{"value":{"data":{"endpoint":"ricerca_persona_fisica","stato":"in_erogazione","callback":false,"parametri":{"cf_piva":"RSSMRA80C24H501J","tipo_catasto":"F","provincia":"ROMA Territorio-RO"},"risultato":null,"esito":null,"timestamp":1625232029,"owner":"test@email.it","id":"60e581c58138e80d804dad20"},"success":true,"message":"","error":null}},"ricerca_nazionale (giuridica)":{"value":{"data":{"endpoint":"ricerca_nazionale_pg","stato":"in_erogazione","callback":false,"parametri":{"cf_piva":"12485671007","tipo_catasto":"TF","provincia":"NAZIONALE-IT"},"risultato":null,"esito":null,"timestamp":1625232029,"owner":"test@email.it","id":"60e581c58138e80d804dad20"},"success":true,"message":"","error":null}},"ricerca_nazionale (fisica)":{"value":{"data":{"endpoint":"ricerca_nazionale_pf","stato":"in_erogazione","callback":false,"parametri":{"cf_piva":"RSSMRA80C24H501J","tipo_catasto":"TF","provincia":"NAZIONALE-IT"},"risultato":null,"esito":null,"timestamp":1625232029,"owner":"test@email.it","id":"60e581c58138e80d804dad20"},"success":true,"message":"","error":null}},"indirizzo":{"value":{"data":{"endpoint":"indirizzo","stato":"in_erogazione","callback":false,"parametri":{"id_indirizzo":"MjUwNSMyMzYjVklBIERFTCBSSVZP","dal_civico":2,"al_civico":3},"risultato":null,"esito":null,"timestamp":1625232029,"owner":"test@email.it","id":"60e581c58138e80d804dad20"},"success":true,"message":"","error":null}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"wrong endpoint","error":255,"data":null}}}},"402":{"description":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"Insufficient Credit in Wallet: 182.03","error":246,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"tipo_catasto not valid","error":210,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"example":{"success":false,"message":"provincia required","error":223,"data":null}}}}}}},"/richiesta":{"get":{"tags":["Richiesta"],"summary":"Ruft alle Anfragen ab","description":"Mit dieser Methode können Sie alle von Ihnen getätigten Anfragen einsehen","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Richieste"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"60e584d6a280fd2c0a05fbe5","endpoint":"elenco_immobili","stato":"in_erogazione","timestamp":1625654486,"owner":"test@email.it"},{"id":"60e581c58138e80d804dad20","endpoint":"indirizzo","stato":"evasa","timestamp":1625653701,"owner":"test@email.it"},{"id":"60e580f1617b512c3450d3c7","endpoint":"ricerca_nazionale_pg","stato":"evasa","timestamp":1625653489,"owner":"test@email.it"}],"success":true,"message":"","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no request linked to this account","error":202,"data":null}}}}}}},"/richiesta/{id}":{"get":{"tags":["Richiesta"],"summary":"Details zur Anfrage","description":"Ermöglicht es Ihnen, die Details der Anfrage anzuzeigen, die durch die ID identifiziert wird","parameters":[{"name":"id","in":"path","description":"Anfrage-ID","required":true,"schema":{"type":"string","example":"60e580f1617b512c3450d3c7"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RispostaPostRichiesta"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"endpoint":"ricerca_nazionale_pg","stato":"evasa","callback":false,"parametri":{"cf_piva":"12485671007","tipo_catasto":"TF","provincia":"NAZIONALE-IT"},"risultato":{"soggetti":[{"denominazione":"OPENAPI SRL","sede":"ROMA (RM)","cf":"12485671007","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","catasti":[{"citta":"ROMA","fabbricati":1,"terreni":0,"provincia":"RM","comuni":[{"comune":"ROMA","fabbricati":1,"terreni":0}]}]}]},"esito":"OK","timestamp":1625232029,"owner":"test@email.it","id":"60e580f1617b512c3450d3c7"},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":203,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no request found","error":204,"data":null}}}}}}},"/indirizzo":{"post":{"tags":["Indirizzo"],"summary":"Adresssuchanfrage erstellen","description":"Mit dieser Methode können Sie eine Anfrage erstellen, um eine **id_indirizzo** abzurufen, die anschließend im Endpunkt **POST /richiesta/indirizzo** verwendet wird.\n","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyPostRicercaIndirizzo"},"example":{"provincia":"TR","comune":"Terni","sezione":"","indirizzo":"del rivo"}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RisultatoRichiestaIndirizzo"},"custom":{"type":"object","nullable":true,"additionalProperties":true}}},"example":{"data":{"endpoint":"ricerca_indirizzo","stato":"evasa","callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"parametri":{"provincia":"TERNI Territorio-TR","comune":"L117#TERNI#0#0","sezione":"","indirizzo":"DEL RIVO"},"risultato":{"indirizzi":[{"id_indirizzo":"NDUyODgwIzI0MCNUZXJyaXRvcmlvIzI0IyNWSUFMRSBGSUxJUFBPIFRPTU1BU08gTUFSSU5FVFRJ","indirizzo":"VIA DEL RIVO"}]},"esito":"OK","timestamp":1751016345,"owner":"test@email.it","id":"485e6399966a385c6f0416c2"},"custom":null}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RispostaPostIndirizzo"},"example":{"data":{"endpoint":"ricerca_indirizzo","stato":"in_erogazione","callback":false,"parametri":{"provincia":"TERNI Territorio-TR","comune":"L117#TERNI#0#0","sezione":"","indirizzo":"VIA DEL RIVO"},"risultato":null,"esito":null,"timestamp":1751016345,"owner":"test@email.it","id":"685e6399966a385c6f0416c4"},"success":true,"message":"","error":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"provincia not valid","error":291,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"example":{"success":false,"message":"provincia required","error":290,"data":null}}}}},"security":[{"bearerAuth":[]}]},"get":{"tags":["Indirizzo"],"summary":"Nach einer Adresse suchen","description":"Dieser Endpunkt bietet zwei Funktionen:\n\n- **Synchrone Suche**: Geben Sie die Abfrageparameter (province, Gemeinde, Ortsteil, Adresse) an, um die entsprechende id_indirizzo zu erhalten, die in POST/richiesta/indirizzo verwendet werden kann.\n\n- **Liste anfordern**: Wenn Sie keine Abfrageparameter angeben, erhalten Sie eine Liste der id_indirizzo aus Ihren vorherigen POST/indirizzo-Anfragen.\n","parameters":[{"name":"provincia","in":"query","description":"Province (**Für die synchrone Suche erforderlich**)","required":false,"schema":{"type":"string","example":"TR"}},{"name":"comune","in":"query","description":"City (**Für die synchrone Suche erforderlich**)","required":false,"schema":{"type":"string","example":"TERNI"}},{"name":"sezione","in":"query","description":"City section, if present","required":false,"schema":{"type":"string","example":"Q"}},{"name":"indirizzo","in":"query","description":"Adresse gesucht; bitte nur die Adresse und nicht den Ortsnamen eingeben (**Erforderlich für die synchrone Suche**)","required":false,"schema":{"type":"string","example":"del rivo"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/RispostaSincronaIndirizzi"},{"$ref":"#/components/schemas/RisultatoListaIndirizzi"}]},"examples":{"Synchronous search":{"value":{"data":{"indirizzi":[{"id_indirizzo":"NDUyODgwIzI0MCNUZXJyaXRvcmlvIzI0IyNERUwgUklWTw==","indirizzo":"VIA DEL RIVO"}]},"success":true,"message":"","error":null}},"Request list":{"value":{"data":[{"id":"485e6399966a385c6f0416c2","endpoint":"ricerca_indirizzo","stato":"evasa","timestamp":1751016345,"owner":"test@email.it"},{"id":"755e6399485a385c6f0416m6","endpoint":"ricerca_indirizzo","stato":"evasa","timestamp":1751015263,"owner":"test@email.it"}],"success":true,"message":"","error":null}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no indirizzi linked to this account","error":300,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"provincia not valid","error":248,"data":null}}}},"412":{"description":"Voraussetzung nicht erfüllt","content":{"application/json":{"example":{"success":false,"message":"Sistema momentaneamente non disponibile","error":254,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"example":{"success":false,"message":"indirizzo required","error":253,"data":null}}}}},"security":[{"bearerAuth":[]}]}},"/indirizzo/{id}":{"get":{"tags":["Indirizzo"],"summary":"Angaben zur Adresse","description":"Ermöglicht es Ihnen, die Details des durch die ID „id_indirizzo“ identifizierten Eintrags anzuzeigen.","parameters":[{"name":"id","in":"path","description":"Anfrage-ID","required":true,"schema":{"type":"string","example":"485e6399966a385c6f0416c2"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RisultatoRichiestaIndirizzo"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"endpoint":"ricerca_indirizzo","stato":"evasa","callback":false,"parametri":{"provincia":"TERNI Territorio-TR","comune":"L117#TERNI#0#0","sezione":"","indirizzo":"DEL RIVO"},"risultato":{"indirizzi":[{"id_indirizzo":"NDUyODgwIzI0MCNUZXJyaXRvcmlvIzI0IyNWSUFMRSBGSUxJUFBPIFRPTU1BU08gTUFSSU5FVFRJ","indirizzo":"VIA DEL RIVO"}]},"esito":"OK","timestamp":1751016345,"owner":"test@email.it","id":"485e6399966a385c6f0416c2"},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":301,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no id_indirizzo found","error":302,"data":null}}}}},"security":[{"bearerAuth":[]}]}},"/visura_catastale":{"post":{"tags":["Visura Catastale"],"summary":"Visura-Anfrage erstellen","description":"Erstellen Sie eine Anfrage zur Einholung einer Visura Catastale (Grundstück oder Objekt).\n\n• Nach Grundstück (**entita: immobile**)\n\n  - Mit id_immobile: Die Anfrage erfolgt direkt unter Verwendung der Grundstückskennung.\n\n  - Ohne id_immobile: Die Anfrage erfolgt anhand der verfügbaren Katasterdaten.\n\n• Nach Rechtsträger (**entita: soggetto**)\n\n  - Mit id_soggetto: Die Angabe der province (provincia) ist optional. Wird sie angegeben, erfolgt die Visura für diese province; wird sie weggelassen, erfolgt die Visura für die erste verfügbare province, die für diesen Rechtsträger zurückgegeben wird.\n\n  - Ohne id_soggetto: Die Anfrage wird anhand der verfügbaren Daten zum Subjekt durchgeführt.\n\n• **tipo_visura** kann „ordinaria“ oder „storica“ lauten.\n\n• **tipo_dettaglio** kann „sintetica“ oder „analitica“ lauten.\n\nBei Objekten gilt: Wird **tipo_dettaglio** weggelassen, ist die Katasterauskunft standardmäßig „sintetica“.\n\nBei Grundstücken gilt: Wird **tipo_dettaglio** weggelassen, ist die Katasterauskunft „storica“ standardmäßig „analitica“. Die Katasterauskunft „ordinaria“ ist immer vollständig, daher wird **tipo_dettaglio** ignoriert.\n\n• **tipo_formato** ist optional und kann **„pdf“**, **„xml“** oder **„json“** lauten.\n\nWird **tipo_formato** weggelassen, wird das Dokument standardmäßig im PDF-Format generiert.\n\nVerwenden Sie **tipo_formato: „xml“**, um die Katasterauskunft im XML-Format anzufordern.\n\nVerwenden Sie **tipo_formato: „json“**, um die Katasterauskunft im JSON-Format anzufordern.\n\nFür XML und JSON gelten dieselben Regeln.\n\nBei Anfragen zu Rechtsträgern (**entita: soggetto**) sind XML und JSON nur mit **tipo_visura: \"ordinaria\"** und **tipo_dettaglio: \"analitica\"** verfügbar.\n\nBei Anfragen zu Immobilien (**entita: immobile**) sind XML und JSON mit **tipo_visura: \"ordinaria\"** oder mit **tipo_visura: \"storica\"**, wenn **tipo_dettaglio** den Wert **\"analitica\"** hat oder **weggelassen** wird.\n\nBei XML- und JSON-Dokumenten enthält die Antwort ein **risultato**-Feld mit dem Hauptteil des Katasterauszugs.\n\nDie Antwort gibt eine **Anfrage-ID** zurück. Überprüfen Sie den Status mit **GET /visura_catastale/{id}** und laden Sie das Dokument mit **GET /visura_catastale/{id}/documento** herunter, sobald es verfügbar ist.\n\nDas heruntergeladene Dokument wird im Format **PDF**, **XML** oder **JSON** zurückgegeben.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/BodyVisuraImmobile"},{"$ref":"#/components/schemas/BodyVisuraSoggetto"}]},"examples":{"immobile_id":{"value":{"entita":"immobile","id_immobile":"MTY1NjcyOCMxNjU2NzI4I0YjODcyIzQwNSNINTAxIzIyNTkyNjkjNDgjICNST01B","tipo_visura":"ordinaria","richiedente":"jane doe"}},"immobile_no_id":{"value":{"entita":"immobile","tipo_catasto":"f","provincia":"rm","comune":"roma","foglio":872,"particella":405,"subalterno":48,"tipo_visura":"storica","tipo_formato":"xml","richiedente":"jane doe"}},"soggetto_id":{"value":{"entita":"soggetto","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","tipo_visura":"storica","tipo_catasto":"f","tipo_dettaglio":"analitica","richiedente":"jane doe","provincia":"rm"}},"soggetto_no_id":{"value":{"entita":"soggetto","tipo_visura":"ordinaria","tipo_dettaglio":"analitica","tipo_formato":"xml","tipo_catasto":"f","cf_piva":"12485671007","provincia":"rm","richiedente":"jane doe"}}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Visura"},"custom":{"type":"object","nullable":true,"additionalProperties":true}}},"example":{"data":{"entita":"soggetto","stato":"evasa","callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"parametri":{"id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","tipo_catasto":"F","tipo_dettaglio":"analitica","cf_piva":"12485671007","provincia":"ROMA Territorio-RM"},"tipo_visura":"ordinaria","richiedente":"jane doe","documento":"628e41900e304d63044f857d.pdf","esito":"OK","timestamp":1653490064,"owner":"test@email.it","id":"628e41900e304d63044f857d"},"custom":null}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Visura"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"immobile_id":{"value":{"data":{"entita":"immobile","stato":"in_erogazione","callback":false,"parametri":{"id_immobile":"MTY1NjcyOCMxNjU2NzI4I0YjODcyIzQwNSNINTAxIzIyNTkyNjkjNDgjICNST01B","tipo_catasto":"F","tipo_dettaglio":null,"foglio":872,"particella":405,"subalterno":48,"comune":"H501#ROMA#4#0","sezione":null,"sezione_urbana":null,"provincia":"ROMA Territorio-RM"},"tipo_visura":"ordinaria","richiedente":"jane doe","documento":null,"esito":null,"timestamp":1653489879,"owner":"test@email.it","id":"628e40d77ee3b06fb03350ca"},"success":true,"message":"","error":null}},"immobile_no_id":{"value":{"data":{"entita":"immobile","stato":"in_erogazione","callback":false,"parametri":{"id_immobile":null,"tipo_catasto":"F","tipo_dettaglio":"sintetica","foglio":872,"particella":405,"subalterno":48,"comune":"H501#ROMA#4#0","sezione":null,"sezione_urbana":null,"provincia":"ROMA Territorio-RM"},"tipo_visura":"ordinaria","richiedente":"jane doe","documento":null,"esito":null,"timestamp":1655308768,"owner":"test@email.it","id":"62aa01e18c75fd55685d07b3"},"success":true,"message":"","error":null}},"soggetto_id":{"value":{"data":{"entita":"soggetto","stato":"in_erogazione","callback":false,"parametri":{"id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","tipo_catasto":"F","tipo_dettaglio":"analitica","cf_piva":"12485671007","provincia":"ROMA Territorio-RM"},"tipo_visura":"ordinaria","richiedente":"jane doe","documento":null,"esito":null,"timestamp":1653490064,"owner":"test@email.it","id":"628e41900e304d63044f857d"},"success":true,"message":"","error":null}},"soggetto_no_id":{"value":{"data":{"entita":"soggetto","stato":"in_erogazione","callback":false,"parametri":{"id_soggetto":null,"tipo_catasto":"F","tipo_dettaglio":null,"cf_piva":"12485671007","provincia":"ROMA Territorio-RM"},"tipo_visura":"ordinaria","richiedente":"jane doe","documento":null,"esito":null,"timestamp":1655308469,"owner":"test@email.it","id":"62aa00b6efbe6d0e52323073"},"success":true,"message":"","error":null}}}}}},"402":{"description":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"billing Error message  . $checkout->message .  code  . $checkout->error","error":284,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"id_immobile not valid","error":258,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"example":{"success":false,"message":"tipo_visura required","error":279,"data":null}}}}}},"get":{"tags":["Visura Catastale"],"summary":"Ruft alle Visuren ab","description":"Mit dieser Methode können Sie alle von Ihnen erstellten Visuren einsehen.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Visure"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"628e41900e304d63044f857d","entita":"soggetto","stato":"in_erogazione","timestamp":1653490064,"owner":"test@email.it"},{"id":"628e40d77ee3b06fb03350ca","entita":"immobile","stato":"in_erogazione","timestamp":1653489879,"owner":"test@email.it"}],"success":true,"message":"","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no visure linked to this account","error":285,"data":null}}}}}}},"/visura_catastale/{id}":{"get":{"tags":["Visura Catastale"],"summary":"Detailansicht der Visura","description":"Hier können Sie die Details der Visura einsehen, die durch die ID identifiziert wird.","parameters":[{"name":"id","in":"path","description":"Visura-ID","required":true,"schema":{"type":"string","example":"628e41900e304d63044f857d"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Visura"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"examples":{"pdf":{"value":{"data":{"entita":"soggetto","stato":"evasa","callback":false,"parametri":{"id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","tipo_catasto":"F","tipo_dettaglio":"analitica","cf_piva":"12485671007","provincia":"ROMA Territorio-RM"},"tipo_visura":"ordinaria","richiedente":"jane doe","documento":"628e41900e304d63044f857d.pdf","esito":"OK","timestamp":1653490064,"owner":"test@email.it","id":"628e41900e304d63044f857d"},"success":true,"message":"","error":null}},"xml":{"value":{"data":{"entita":"soggetto","stato":"evasa","callback":false,"parametri":{"tipo_visura":"ordinaria","tipo_catasto":"F","tipo_dettaglio":"analitica","tipo_formato":"xml","cf_piva":"RSSMRA80A01H501U","provincia":"ROMA Territorio-RM"},"risultato":{"VisuraSoggettoAttuale":{"TitoloVisura":{"@attibrutes":{"Titolo":"Visura attuale soggetto","SituazioneAl":"19700101","Provenienza":"Direzione Provinciale di Roma Ufficio Provinciale - Territorio","TipoServizio":"Servizi Catastali","TipoVisura":"Visura telematica","Data":"19700101","Ora":"104127"}},"DatiRichiesta":{"@attibrutes":{"TipoCatasto":"F","Provincia":"RM","CodiceComune":"","Comune":"","Protocollo":"T000000","Anno":"1970"},"SoggettoIndividuato":{"SoggettoPF":{"@attibrutes":{"CodiceFiscale":"RSSMRA80A01H501U","Cognome":"ROSSI","Nome":"MARIO","Sesso":"M","DataNascita":"01/01/1980","CodiceComune":"H501","Provincia":"RM","ComuneNascita":"Roma"}}}},"GruppoUnitaImmobiliari":{"@attibrutes":{"IndiceGruppo":"1","TipoCatasto":"F","CodiceComune":"H501","Descrizione":"ROMA"},"ImmobileFabbricatiS":[{"@attibrutes":{"IndiceImmobile":"1"},"DatiIdentificativi":{"IdentificativoDefinitivo":{"@attibrutes":{"Provincia":"RM","CodiceComune":"H501","Comune":"ROMA","Foglio":"123","ParticellaNum":"123","Subalterno":"123","ProgrId":"1"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"COSTITUZIONE del 01/01/1970 in atti dal 01/01/1970 (n. 123/1970)"}}}},"DatiIndirizzo":{"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"VARIAZIONE TOPONOMASTICA del 01/01/1970 Pratica n. 123  in atti dal 01/01/1970 VARIAZIONE DI TOPONOMASTICA (n. 123/1970)"}},"IndirizzoImm":"VIA MARIO ROSSI"},"MappaliCorrelati":{"IdentificativoCorrelato":{"@attibrutes":{"SezCensuaria":" ","Foglio":"123","ParticellaNum":"123"}}},"DatiClassamentoF":{"@attibrutes":{"Categoria":"A/2: ABITAZIONI DI TIPO CIVILE","Classe":"3","RenditaEuro":"123"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"CLASSAMENTO AUTOMATICO del 01/01/1970 in atti dal 01/01/1970 (n. 123/1970)"}},"Consistenza":{"@attibrutes":{"Valore":"12","Unita":"VANI"}}},"SuperficieF":{"@attibrutes":{"Totale":"123","TotaleE":"123"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"Superficie di impianto pubblicata il 01/01/1970 "}},"PlanimeRMia":{"@attibrutes":{"Descrizione":"  Dati relativi alla planimeRMia: data di presentazione 01/01/1970, prot. n. 123"}}}},{"@attibrutes":{"IndiceImmobile":"123"},"DatiIdentificativi":{"IdentificativoDefinitivo":{"@attibrutes":{"Provincia":"RM","CodiceComune":"H501","Comune":"ROMA ","Foglio":"123","ParticellaNum":"123","Subalterno":"123","ProgrId":"1"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"COSTITUZIONE del 01/01/1970 in atti dal 01/01/1970 (n. 123/1970)"}}}},"DatiIndirizzo":{"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"VARIAZIONE TOPONOMASTICA del 01/01/1970 Pratica n. 123  in atti dal 01/01/1970 VARIAZIONE TOPONOMASTICA D'UFFICIO (n. 123/1970)"}},"IndirizzoImm":"VIA MARIO ROSSI"},"MappaliCorrelati":{"IdentificativoCorrelato":{"@attibrutes":{"SezCensuaria":" ","Foglio":"123","ParticellaNum":"123"}}},"DatiClassamentoF":{"@attibrutes":{"Categoria":"C/6: STALLE, SCUDERIE, RIMESSE E AUTORIMESSE","Classe":"2","RenditaEuro":"123"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"CLASSAMENTO AUTOMATICO del 01/01/1970 in atti dal 01/01/1970 (n. 123/1970)"}},"Consistenza":{"@attibrutes":{"Valore":"123","Unita":"MQ"}}},"SuperficieF":{"@attibrutes":{"Totale":"123"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"Superficie di impianto pubblicata il 01/01/1970  "}},"PlanimeRMia":{"@attibrutes":{"Descrizione":"  Dati relativi alla planimeRMia: data di presentazione 01/01/1970, prot. n. 123"}}}}],"IntestazioneGruppo":{"MutazioneSoggettiva":{"@attibrutes":{"IndiceMutazione":"1"},"DatiDerivantiDaMutazSogg":"Atto  del 01/01/1970 Pubblico ufficiale Mario Rossi Sede Roma (RM) Repertorio n. 123 - COMPRAVENDITA Nota presentata con Modello Unico n. 123/1970 Reparto PI di Roma in atti dal 01/01/1970","Intestazione":{"Intestato":{"@attibrutes":{"IndiceIntestato":"1"},"Nominativo":"ROSSI MARIO  01/01/1980; Comune Roma (RM)","CF":"RSSMRA80A01H501U","DirittiReali":{"@attibrutes":{"Quota":" per 1/1","CodiceDiritto":"01","Descrizione":"Proprieta'","FineDiritto":"dal 01/01/1970 al 01/01/1970"}}}}}}},"DatiLiquidazione":{"@attibrutes":{"Protocollo":"T000000","Anno":"1970","UnitaImmobiliari":"0"}},"Richiedente":{"@attibrutes":{"Descrizione":""}}}},"tipo_visura":"ordinaria","richiedente":"jane doe","documento":"628e41900e304d63044f857d.xml","esito":"OK","timestamp":1653490064,"owner":"test@email.it","id":"628e41900e304d63044f857d"},"success":true,"message":"","error":null}},"json":{"value":{"data":{"entita":"soggetto","stato":"evasa","callback":false,"parametri":{"tipo_visura":"ordinaria","tipo_catasto":"F","tipo_dettaglio":"analitica","tipo_formato":"json","cf_piva":"RSSMRA80A01H501U","provincia":"ROMA Territorio-RM"},"risultato":{"VisuraSoggettoAttuale":{"TitoloVisura":{"@attibrutes":{"Titolo":"Visura attuale soggetto","SituazioneAl":"19700101","Provenienza":"Direzione Provinciale di Roma Ufficio Provinciale - Territorio","TipoServizio":"Servizi Catastali","TipoVisura":"Visura telematica","Data":"19700101","Ora":"104127"}},"DatiRichiesta":{"@attibrutes":{"TipoCatasto":"F","Provincia":"RM","CodiceComune":"","Comune":"","Protocollo":"T000000","Anno":"1970"},"SoggettoIndividuato":{"SoggettoPF":{"@attibrutes":{"CodiceFiscale":"RSSMRA80A01H501U","Cognome":"ROSSI","Nome":"MARIO","Sesso":"M","DataNascita":"01/01/1980","CodiceComune":"H501","Provincia":"RM","ComuneNascita":"Roma"}}}},"GruppoUnitaImmobiliari":{"@attibrutes":{"IndiceGruppo":"1","TipoCatasto":"F","CodiceComune":"H501","Descrizione":"ROMA"},"ImmobileFabbricatiS":[{"@attibrutes":{"IndiceImmobile":"1"},"DatiIdentificativi":{"IdentificativoDefinitivo":{"@attibrutes":{"Provincia":"RM","CodiceComune":"H501","Comune":"ROMA","Foglio":"123","ParticellaNum":"123","Subalterno":"123","ProgrId":"1"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"COSTITUZIONE del 01/01/1970 in atti dal 01/01/1970 (n. 123/1970)"}}}},"DatiIndirizzo":{"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"VARIAZIONE TOPONOMASTICA del 01/01/1970 Pratica n. 123  in atti dal 01/01/1970 VARIAZIONE DI TOPONOMASTICA (n. 123/1970)"}},"IndirizzoImm":"VIA MARIO ROSSI"},"MappaliCorrelati":{"IdentificativoCorrelato":{"@attibrutes":{"SezCensuaria":" ","Foglio":"123","ParticellaNum":"123"}}},"DatiClassamentoF":{"@attibrutes":{"Categoria":"A/2: ABITAZIONI DI TIPO CIVILE","Classe":"3","RenditaEuro":"123"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"CLASSAMENTO AUTOMATICO del 01/01/1970 in atti dal 01/01/1970 (n. 123/1970)"}},"Consistenza":{"@attibrutes":{"Valore":"12","Unita":"VANI"}}},"SuperficieF":{"@attibrutes":{"Totale":"123","TotaleE":"123"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"Superficie di impianto pubblicata il 01/01/1970 "}},"PlanimeRMia":{"@attibrutes":{"Descrizione":"  Dati relativi alla planimeRMia: data di presentazione 01/01/1970, prot. n. 123"}}}},{"@attibrutes":{"IndiceImmobile":"123"},"DatiIdentificativi":{"IdentificativoDefinitivo":{"@attibrutes":{"Provincia":"RM","CodiceComune":"H501","Comune":"ROMA ","Foglio":"123","ParticellaNum":"123","Subalterno":"123","ProgrId":"1"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"COSTITUZIONE del 01/01/1970 in atti dal 01/01/1970 (n. 123/1970)"}}}},"DatiIndirizzo":{"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"VARIAZIONE TOPONOMASTICA del 01/01/1970 Pratica n. 123  in atti dal 01/01/1970 VARIAZIONE TOPONOMASTICA D'UFFICIO (n. 123/1970)"}},"IndirizzoImm":"VIA MARIO ROSSI"},"MappaliCorrelati":{"IdentificativoCorrelato":{"@attibrutes":{"SezCensuaria":" ","Foglio":"123","ParticellaNum":"123"}}},"DatiClassamentoF":{"@attibrutes":{"Categoria":"C/6: STALLE, SCUDERIE, RIMESSE E AUTORIMESSE","Classe":"2","RenditaEuro":"123"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"CLASSAMENTO AUTOMATICO del 01/01/1970 in atti dal 01/01/1970 (n. 123/1970)"}},"Consistenza":{"@attibrutes":{"Valore":"123","Unita":"MQ"}}},"SuperficieF":{"@attibrutes":{"Totale":"123"},"DatiDerivantiDa":{"@attibrutes":{"Descrizione":"Superficie di impianto pubblicata il 01/01/1970  "}},"PlanimeRMia":{"@attibrutes":{"Descrizione":"  Dati relativi alla planimeRMia: data di presentazione 01/01/1970, prot. n. 123"}}}}],"IntestazioneGruppo":{"MutazioneSoggettiva":{"@attibrutes":{"IndiceMutazione":"1"},"DatiDerivantiDaMutazSogg":"Atto  del 01/01/1970 Pubblico ufficiale Mario Rossi Sede Roma (RM) Repertorio n. 123 - COMPRAVENDITA Nota presentata con Modello Unico n. 123/1970 Reparto PI di Roma in atti dal 01/01/1970","Intestazione":{"Intestato":{"@attibrutes":{"IndiceIntestato":"1"},"Nominativo":"ROSSI MARIO  01/01/1980; Comune Roma (RM)","CF":"RSSMRA80A01H501U","DirittiReali":{"@attibrutes":{"Quota":" per 1/1","CodiceDiritto":"01","Descrizione":"Proprieta'","FineDiritto":"dal 01/01/1970 al 01/01/1970"}}}}}}},"DatiLiquidazione":{"@attibrutes":{"Protocollo":"T000000","Anno":"1970","UnitaImmobiliari":"0"}},"Richiedente":{"@attibrutes":{"Descrizione":""}}}},"tipo_visura":"ordinaria","richiedente":"jane doe","documento":"628e41900e304d63044f857d.json","esito":"OK","timestamp":1653490064,"owner":"test@email.it","id":"628e41900e304d63044f857d"},"success":true,"message":"","error":null}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":286,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no visura found","error":287,"data":null}}}}}}},"/visura_catastale/{id}/documento":{"get":{"tags":["Visura Catastale"],"summary":"Visura herunterladen","description":"Mit dieser Methode können Sie das Dokument direkt herunterladen","parameters":[{"name":"id","in":"path","description":"Visura-ID","required":true,"schema":{"type":"string","example":"628e41900e304d63044f857d"}}],"responses":{"200":{"description":"Inhalt der Datei","content":{"application/PDF":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":286,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no visura found","error":287,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"example":{"success":false,"message":"document not yet available","error":288,"data":null}}}}}}},"/ipotecarie-ispezione_nazionale":{"post":{"tags":["Visura Ipotecaria"],"summary":"Antrag auf Einsichtnahme in das nationale Grundbuch","description":"Startet eine landesweite Grundbuchprüfung für einen durch **cf_piva** identifizierten Eintrag. Die Felder **richiedente** und **motivo** können angegeben werden, um den Antragsteller und den Grund zu spezifizieren.\n\n**Richiedente** muss eine gültige Steuernummer sein.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyIspezioneNazionale"},"example":{"cf_piva":"01114601006","richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita"}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RispostaGetIpotecarie"},"custom":{"type":"object","nullable":true,"additionalProperties":true}}},"example":{"data":{"endpoint":"ispezione_nazionale","stato":"evasa","callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"parametri":{"cf_piva":"RSSMRI85E28H501E","conservatoria":"IT99-0-NAZIONALE"},"risultato":{"soggetti":[{"cognome":"ROSSI","nome":"MARIO","data_nascita":"28/05/1985","sesso":"M","luogo_nascita":"ROMA (RM)","cf":"RSSMRI85E28H501E","conservatorie":[{"conservatoria":"ROMA 1","trascrizioni":"SI","iscrizioni":"NO","annotazioni":"NO"}]}]},"esito":"OK","documento":null,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768837062,"owner":"test@email.it","id":"696e4fc6fb352796ad0dadf0"},"custom":null}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RispostaPostIpotecarie"},"success":{"type":"boolean","example":true},"message":{"type":"string","example":""},"error":{"type":"integer","nullable":true,"example":null}}},"example":{"data":{"endpoint":"ispezione_nazionale","stato":"in_erogazione","callback":null,"parametri":{"cf_piva":"01114601006","conservatoria":"IT99-0-NAZIONALE"},"risultato":null,"esito":null,"documento":null,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768908188,"owner":"test@email.it","id":"696f659cfb66be7939088fad"},"success":true,"message":"","error":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"cf_piva not valid","error":308,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"example":{"success":false,"message":"cf_piva required","error":307,"data":null}}}}}}},"/ipotecarie-elenco-note":{"post":{"tags":["Visura Ipotecaria"],"summary":"Antrag auf Auskunft über Grundbuchvermerke","description":"Startet eine Anfrage zum Abrufen der Liste der Grundbucheinträge (Vermerke/Formalitäten) entweder für eine Immobilie oder eine Person, je nach der angegebenen **entita**. \n\nBei Gebäuden ist die Angabe des Unterobjekts nicht zwingend erforderlich; wird es weggelassen, erfolgt die Suche anhand des ersten Unterobjekts des gesuchten Gebäudes in der Liste.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyIpotecarieElencoNote"},"examples":{"immobile":{"summary":"unbeweglich","value":{"entita":"ispezione_immobile","comune":"ROMA","tipo_catasto":"F","conservatoria":"ROMA 1","foglio":872,"particella":405,"subalterno":5,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita"}},"soggetto":{"summary":"Thema","value":{"entita":"ispezione_soggetto","conservatoria":"ROMA 1","cf_piva":"RSSMRA80A01H501U","richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita"}}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RispostaGetIpotecarie"},"custom":{"type":"object","nullable":true,"additionalProperties":true}}},"example":{"data":{"endpoint":"ispezione_elenco_note","stato":"evasa","callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"parametri":{"entita":"ispezione_immobile","conservatoria":"RM10-19971231-ROMA 1","tipo_catasto":"F","foglio":485,"particella":200,"subalterno":5,"comune":"H501#RMROMA##","sezione":null,"sezione_urbana":null},"risultato":{"immobili":[{"identificativo_definitivo":{"sezione":null,"sezione_urbana":null,"foglio":"1","particella":"1","subalterno":"1"},"identificativo_provvisorio":{"tipo_denuncia":null,"numero":null,"anno":null},"note":[{"tipo_nota":"TRASCRIZIONE A FAVORE","data_nota":"01/01/1970","registro_particolare":"123456","registro_generale":"123456","pubblico_ufficiale":"ROSSI MARIO","repertorio":"123456/123456","data_repertorio":"01/01/1970","tipo_atto":"ATTO TRA VIVI - COMPRAVENDITA","citta":"ROMA","provincia":"RM","documenti_correlati":null}]}]},"esito":"OK","documento":"696e3d058ea94d2088028d9e.pdf","richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768832261,"owner":"test@email.it","id":"628e41900e304d63044f857d"},"custom":null}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RispostaPostIpotecarie"},"success":{"type":"boolean","example":true},"message":{"type":"string","example":""},"error":{"type":"integer","nullable":true,"example":null}}},"examples":{"ok_immobile":{"summary":"Anfrage gestartet (unbeweglich)","value":{"data":{"endpoint":"ispezione_elenco_note","stato":"in_erogazione","callback":null,"parametri":{"entita":"ispezione_immobile","conservatoria":"RM10-19971231-ROMA 1","tipo_catasto":"F","foglio":875,"particella":"405","subalterno":5,"comune":"H501#RMROMA##","sezione":null,"sezione_urbana":null},"risultato":null,"esito":null,"documento":null,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768907012,"owner":"test@email.it","id":"696f6104fb66be7939088fa3"},"success":true,"message":"","error":null}},"ok_soggetto":{"summary":"Anfrage gestartet (Betreff)","value":{"data":{"endpoint":"ispezione_elenco_note","stato":"in_erogazione","callback":null,"parametri":{"entita":"ispezione_soggetto","cf_piva":"RSSMRA80A01H501U","conservatoria":"RM10-19971231-ROMA 1"},"risultato":null,"esito":null,"documento":null,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768907179,"owner":"test@email.it","id":"696f61abfb66be7939088fa4"},"success":true,"message":"","error":null}}}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"examples":{"entita_required":{"summary":"Fehlende Entität","value":{"success":false,"message":"entita required","error":309,"data":null}},"comune_required":{"summary":"Fehlende Gemeinde (Immobilie)","value":{"success":false,"message":"comune required","error":311,"data":null}},"tipo_catasto_required":{"summary":"Fehlender „tipo_catasto“ (Immobilie)","value":{"success":false,"message":"tipo_catasto required","error":313,"data":null}},"conservatoria_required":{"summary":"Fehlende Konservatorien","value":{"success":false,"message":"conservatoria required","error":319,"data":null}}}}}}}}},"/ipotecarie-dettaglio-nota":{"post":{"tags":["Visura Ipotecaria"],"summary":"Anfrage zu den Einzelheiten einer Grundbuchvermerksangabe","description":"Startet eine Anfrage zum Abruf der Einzelheiten eines Grundbuchvermerks (formalità) ein, entweder für eine Person (natürliche/juristische) oder eine Immobilie, unter Verwendung der **allgemeinen** oder **spezifischen** Grundbuchreferenzen.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyIpotecarieDettaglioNota"},"examples":{"soggetto_generale":{"summary":"Betreff – Allgemeines Register","value":{"tipo_restrizione":"soggetto","tipo_registro":"generale","anno":2025,"conservatoria":"ROMA 1","registro_generale":10206,"cf_piva":"RSSMRA80A01H501U","richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita"}},"soggetto_particolare":{"summary":"Betreff – Bestimmtes Register","value":{"tipo_restrizione":"soggetto","tipo_registro":"particolare","anno":2025,"conservatoria":"ROMA 1","tipo_nota":"trascrizioni","registro_particolare":123456,"cf_piva":"RSSMRA80A01H501U","richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita"}},"immobile_generale":{"summary":"Immobilien – Allgemeines Register","value":{"tipo_restrizione":"immobile","tipo_registro":"generale","anno":2025,"conservatoria":"ROMA 1","registro_generale":123456,"comune":"ROMA","tipo_catasto":"F","foglio":405,"particella":875,"subalterno":5,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita"}},"immobile_particolare":{"summary":"Immobilien – Sonderregister","value":{"tipo_restrizione":"immobile","tipo_registro":"particolare","anno":2025,"conservatoria":"ROMA 1","tipo_nota":"trascrizioni","registro_particolare":123456,"comune":"ROMA","tipo_catasto":"F","foglio":405,"particella":875,"subalterno":5,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita"}}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RispostaGetIpotecarie"},"custom":{"type":"object","nullable":true,"additionalProperties":true}}},"example":{"data":{"endpoint":"ispezione_dettaglio_nota","stato":"evasa","callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"parametri":{"anno":2025,"conservatoria":"RM10-19971231-ROMA 1","registro_generale":123456,"tipo_restrizione":"soggetto_fisico","cf_piva":"RSSMRI85E28H501E"},"risultato":{"nota":{"tipo_nota":"TRASCRIZIONE","data_nota":"19/04/2019","registro_particolare":"123456","registro_generale":"123456"}},"esito":"OK","documento":"696e38edfb352796ad0dade8.pdf","richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768831213,"owner":"test@email.it","id":"696e38edfb352796ad0dade8"},"custom":null}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RispostaPostIpotecarie"},"success":{"type":"boolean","example":true},"message":{"type":"string","example":""},"error":{"type":"integer","nullable":true,"example":null}}},"examples":{"ok_soggetto_generale":{"summary":"Anfrage gestartet (Betreff, allgemeines Register)","value":{"data":{"endpoint":"ispezione_dettaglio_nota","stato":"in_erogazione","callback":null,"parametri":{"anno":2025,"conservatoria":"RM10-19971231-ROMA 1","registro_generale":10206,"tipo_restrizione":"soggetto_fisico","cf_piva":"RSSMRA80A01H501U"},"risultato":null,"esito":null,"documento":null,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768908842,"owner":"test@email.it","id":"696f682a9fbbc9f3e80c6e46"},"success":true,"message":"","error":null}},"ok_soggetto_particolare":{"summary":"Anfrage gestartet (Betreff, bestimmte Register)","value":{"data":{"endpoint":"ispezione_dettaglio_nota","stato":"in_erogazione","callback":null,"parametri":{"anno":2025,"conservatoria":"RM10-19971231-ROMA 1","tipo_nota":"TRASCRIZIONI","registro_particolare":123456,"tipo_restrizione":"soggetto_fisico","cf_piva":"RSSMRA80A01H501U"},"risultato":null,"esito":null,"documento":null,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768908951,"owner":"test@email.it","id":"696f6897fb66be7939088fae"},"success":true,"message":"","error":null}},"ok_immobile_particolare":{"summary":"Antrag gestartet (Immobilie, bestimmtes Grundbuch)","value":{"data":{"endpoint":"ispezione_dettaglio_nota","stato":"in_erogazione","callback":null,"parametri":{"anno":2025,"conservatoria":"RM10-19971231-ROMA 1","tipo_nota":"TRASCRIZIONI","registro_particolare":123456,"sezione_urbana":null,"tipo_restrizione":"immobile","tipo_catasto":"F","foglio":405,"particella":875,"subalterno":5,"comune":"H501#RMROMA##","sezione":null},"risultato":null,"esito":null,"documento":null,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768909545,"owner":"test@email.it","id":"696f6ae99fbbc9f3e80c6e48"},"success":true,"message":"","error":null}},"ok_immobile_generale":{"summary":"Antrag gestartet (Immobilie, allgemeines Grundbuch)","value":{"data":{"endpoint":"ispezione_dettaglio_nota","stato":"in_erogazione","callback":null,"parametri":{"anno":2025,"conservatoria":"RM10-19971231-ROMA 1","registro_generale":123456,"sezione_urbana":null,"tipo_restrizione":"immobile","tipo_catasto":"F","foglio":405,"particella":875,"subalterno":5,"comune":"H501#RMROMA##","sezione":null},"risultato":null,"esito":null,"documento":null,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768909637,"owner":"test@email.it","id":"696f6b45fb66be7939088fb1"},"success":true,"message":"","error":null}}}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"examples":{"tipo_restrizione_required":{"summary":"Fehlende „tipo_restrizione“","value":{"success":false,"message":"tipo_restrizione required","error":323,"data":null}},"anno_required":{"summary":"Fehlende Jahresangabe","value":{"success":false,"message":"anno required","error":327,"data":null}},"conservatoria_required":{"summary":"Fehlende Konservatorien","value":{"success":false,"message":"conservatoria required","error":335,"data":null}}}}}}}}},"/ipotecarie":{"get":{"tags":["Visura Ipotecaria"],"summary":"Ruft alle Hypothekenprüfungen ab","description":"Mit dieser Methode können Sie alle von Ihnen gestellten Anträge auf Hypothekenprüfung einsehen.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VisureIpotecarie"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"example":{"data":[{"id":"696e4fc6fb352796ad0dadf0","endpoint":"ispezione_nazionale","stato":"evasa","timestamp":1768837062,"owner":"test@email.it"},{"id":"696e3d058ea94d2088028d9e","endpoint":"ispezione_elenco_note","stato":"in_lavorazione","timestamp":1768832261,"owner":"test@email.it"},{"id":"696e38edfb352796ad0dade8","endpoint":"ispezione_dettaglio_nota","stato":"in_erogazione","timestamp":1768831213,"owner":"test@email.it"}],"success":true,"message":"","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no visure ipotecarie linked to this account","error":350,"data":null}}}}}}},"/ipotecarie/{id}":{"get":{"tags":["Visura Ipotecaria"],"summary":"Einzelheiten zu einem Antrag auf eine Hypothekenprüfung","description":"Hier können Sie die Details der durch die ID identifizierten Anfrage zur Hypothekenprüfung einsehen, einschließlich des Ergebnisses und des Dokuments (sofern verfügbar).","parameters":[{"name":"id","in":"path","description":"Anfrage-ID","required":true,"schema":{"type":"string","example":"696e4fc6fb352796ad0dadf0"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RispostaGetIpotecarie"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"examples":{"ispezione_nazionale(soggetto_fisico)":{"summary":"Nationale Inspektion (soggetto_fisico)","value":{"data":{"endpoint":"ispezione_nazionale","stato":"evasa","callback":null,"parametri":{"cf_piva":"RSSMRI85E28H501E","conservatoria":"IT99-0-NAZIONALE"},"risultato":{"soggetti":[{"cognome":"ROSSI","nome":"MARIO","data_nascita":"28/05/1985","sesso":"M","luogo_nascita":"ROMA (RM)","cf":"RSSMRI85E28H501E","conservatorie":[{"conservatoria":"ROMA 1","trascrizioni":"SI","iscrizioni":"NO","annotazioni":"NO"}]}]},"esito":"OK","documento":null,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768837062,"owner":"test@email.it","id":"696e4fc6fb352796ad0dadf0"},"success":true,"message":"","error":null}},"ispezione_nazionale(soggetto_giuridico)":{"summary":"Nationale Inspektion (Rechtsträger)","value":{"data":{"endpoint":"ispezione_nazionale","stato":"evasa","callback":null,"parametri":{"cf_piva":"RSSMRI85E28H501E","conservatoria":"IT99-0-NAZIONALE"},"risultato":{"soggetti":[{"denominazione":"ALTRAVIA SERVIZI SOCIETA A RESPONSABILITA LIMITATA","sede":"ROMA (RM)","cf":"12485671007","conservatorie":[{"conservatoria":"ROMA 1","trascrizioni":"SI","iscrizioni":"NO","annotazioni":"NO"}]}]},"esito":"OK","documento":null,"richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768837062,"owner":"test@email.it","id":"696e4fc6fb352796ad0dadf0"},"success":true,"message":"","error":null}},"ispezione_elenco_note(immobile)":{"summary":"Notizenliste (unbeweglich)","value":{"data":{"endpoint":"ispezione_elenco_note","stato":"evasa","callback":null,"parametri":{"entita":"ispezione_immobile","conservatoria":"RM10-19971231-ROMA 1","tipo_catasto":"F","foglio":485,"particella":200,"subalterno":5,"comune":"H501#RMROMA##","sezione":null,"sezione_urbana":null},"risultato":{"immobili":[{"identificativo_definitivo":{"sezione":null,"sezione_urbana":null,"foglio":"1","particella":"1","subalterno":"1"},"identificativo_provvisorio":{"tipo_denuncia":null,"numero":null,"anno":null},"note":[{"tipo_nota":"TRASCRIZIONE A FAVORE","data_nota":"01/01/1970","registro_particolare":"123456","registro_generale":"123456","pubblico_ufficiale":"ROSSI MARIO","repertorio":"123456/123456","data_repertorio":"01/01/1970","tipo_atto":"ATTO TRA VIVI - COMPRAVENDITA","citta":"ROMA","provincia":"RM","documenti_correlati":null}]}]},"esito":"OK","documento":"696e3d058ea94d2088028d9e.pdf","richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768832261,"owner":"test@email.it","id":"696e3d058ea94d2088028d9e"},"success":true,"message":"","error":null}},"ispezione_elenco_note(soggetto_fisico)":{"summary":"Notizenliste (soggetto_fisico)","value":{"data":{"endpoint":"ispezione_elenco_note","stato":"evasa","callback":null,"parametri":{"entita\"":"ispezione_soggetto,","cf_piva\"":"RSSMRI85E28H501E,","conservatoria\"":"RM10-19971231-ROMA 1"},"risultato":{"soggetti":[{"cognome":"ROSSI","nome":"MARIO","data_nascita":"28/05/1985","luogo_nascita":"ROMA (RM)","sesso":"M","cf":"RSSMRI85E28H501E","note":[{"tipo_nota":"TRASCRIZIONE A FAVORE","data_nota":"01/01/1970","registro_particolare":"123456","registro_generale":"123456","pubblico_ufficiale":"ROSSI MARIO","repertorio":"123456/123456","data_repertorio":"01/01/1970","tipo_atto":"ATTO TRA VIVI - COMPRAVENDITA","citta":"ROMA","provincia":"RM","documenti_correlati":null}]}]},"esito":"OK","documento":"696e3d058ea94d2088028d9e.pdf","richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768832261,"owner":"test@email.it","id":"696e3d058ea94d2088028d9e"},"success":true,"message":"","error":null}},"ispezione_elenco_note(soggetto_giuridico)":{"summary":"Verzeichnis der Anmerkungen (soggetto_giuridico)","value":{"data":{"endpoint":"ispezione_elenco_note","stato":"evasa","callback":null,"parametri":{"entita":"ispezione_soggetto,","cf_piva":"RSSMRI85E28H501E,","conservatoria":"RM10-19971231-ROMA 1"},"risultato":{"soggetti":[{"denominazione":"ALTRAVIA SERVIZI SOCIETA A RESPONSABILITA LIMITATA","sede":"ROMA (RM)","cf":"12485671007","note":[{"tipo_nota":"TRASCRIZIONE A FAVORE","data_nota":"01/01/1970","registro_particolare":"123456","registro_generale":"123456","pubblico_ufficiale":"ROSSI MARIO","repertorio":"123456/123456","data_repertorio":"01/01/1970","tipo_atto":"ATTO TRA VIVI - COMPRAVENDITA","citta":"ROMA","provincia":"RM","documenti_correlati":null}]}]},"esito":"OK","documento":"696e3d058ea94d2088028d9e.pdf","richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768832261,"owner":"test@email.it","id":"696e3d058ea94d2088028d9e"},"success":true,"message":"","error":null}},"ispezione_dettaglio_nota":{"summary":"Anmerkung: Detail","value":{"data":{"endpoint":"ispezione_dettaglio_nota","stato":"evasa","callback":null,"parametri":{"anno":2025,"conservatoria":"RM10-19971231-ROMA 1","registro_generale":123456,"tipo_restrizione":"soggetto_fisico","cf_piva":"RSSMRI85E28H501E"},"risultato":{"nota":{"tipo_nota":"TRASCRIZIONE","data_nota":"19/04/2019","registro_particolare":"123456","registro_generale":"123456"}},"esito":"OK","documento":"696e38edfb352796ad0dade8.pdf","richiedente":"RSSMRA80A01H501U","motivo":"verifica preliminare per compravendita","timestamp":1768831213,"owner":"test@email.it","id":"696e38edfb352796ad0dade8"},"success":true,"message":"","error":null}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":286,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no visura ipotecaria found","error":347,"data":null}}}}}}},"/ipotecarie/{id}/documento":{"get":{"tags":["Visura Ipotecaria"],"summary":"Visura herunterladen","description":"Mit dieser Methode können Sie das Dokument direkt herunterladen","parameters":[{"name":"id","in":"path","description":"Visura-ID","required":true,"schema":{"type":"string","example":"628e41900e304d63044f857d"}}],"responses":{"200":{"description":"Inhalt der Datei","content":{"application/PDF":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":286,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no visura found","error":287,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"example":{"success":false,"message":"document not yet available","error":288,"data":null}}}}}}},"/estratto_mappa":{"post":{"tags":["Estratto Mappa"],"summary":"Anfrage für einen Kartenausschnitt erstellen","description":"Erstellen Sie eine Anfrage, um einen Kartenauszug für das Kataster (Catasto Terreni) zu erhalten.\n\nDer Parameter „section“ ist für Gemeinden, die dies verlangen, obligatorisch. Sie können über den Endpunkt GET /territorio/{provincia}/{comune}?tipo_catasto=t überprüfen, ob ein Abschnitt erforderlich ist.\n\nDie Anfrage gibt eine Anfrage-ID zurück. Verwenden Sie diese ID, um den Status über GET /estratto_mappa/{id} zu verfolgen und das PDF-Dokument über GET /estratto_mappa/{id}/documento herunterzuladen, sobald der Status „evasa“ lautet.\n","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyEstrattoMappa"},"example":{"provincia":"RM","comune":"ROMA","foglio":872,"particella":405}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/EstrattoMappa"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"endpoint":"estratto_mappa","stato":"in_erogazione","callback":false,"parametri":{"foglio":872,"particella":405,"comune":"H501#ROMA#4#0","sezione":null,"provincia":"ROMA Territorio-RM"},"documento":null,"esito":null,"timestamp":1655308768,"owner":"test@email.it","id":"62aa01e18c75fd55685d07b3"},"success":true,"message":"","error":null}}}},"402":{"description":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"billing Error message  . $checkout->message .  code  . $checkout->error","error":284,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"provincia not valid","error":351,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"example":{"success":false,"message":"comune required","error":352,"data":null}}}}}},"get":{"tags":["Estratto Mappa"],"summary":"Ruft alle Anfragen ab","description":"Mit dieser Methode können Sie alle von Ihnen erstellten Abfragen zur Extraktkarte einsehen.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EstrattoMappa"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"628e41900e304d63044f857d","endpoint":"estratto_mappa","stato":"in_erogazione","timestamp":1653490064,"owner":"test@email.it"},{"id":"628e40d77ee3b06fb03350ca","endpoint":"estratto_mappa","stato":"in_lavorazione","timestamp":1653489879,"owner":"test@email.it"},{"id":"628e40d77ee3b06fb03350ca","endpoint":"estratto_mappa","stato":"evasa","timestamp":1653489879,"owner":"test@email.it"}],"success":true,"message":"","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no estratti mappa linked to this account","error":360,"data":null}}}}}}},"/estratto_mappa/{id}":{"get":{"tags":["Estratto Mappa"],"summary":"Ausschnitt aus der Karte","description":"Ermöglicht es Ihnen, die Details der durch die ID identifizierten Auszugskarte anzuzeigen","parameters":[{"name":"id","in":"path","description":"Karten-ID extrahieren","required":true,"schema":{"type":"string","example":"628e41900e304d63044f857d"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/EstrattoMappa"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"endpoint":"estratto_mappa","stato":"evasa","callback":false,"parametri":{"foglio":872,"particella":405,"comune":"H501#ROMA#4#0","sezione":null,"provincia":"ROMA Territorio-RM"},"documento":"628e41900e304d63044f857d.pdf","esito":"OK","timestamp":1653490064,"owner":"test@email.it","id":"628e41900e304d63044f857d"},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":286,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no estratto mappa found","error":361,"data":null}}}}}}},"/estratto_mappa/{id}/documento":{"get":{"tags":["Estratto Mappa"],"summary":"Karte herunterladen","description":"Mit dieser Methode können Sie das Dokument direkt herunterladen","parameters":[{"name":"id","in":"path","description":"Karten-ID extrahieren","required":true,"schema":{"type":"string","example":"628e41900e304d63044f857d"}}],"responses":{"200":{"description":"Inhalt der Datei","content":{"application/PDF":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":286,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"example":{"success":false,"message":"document not yet available","error":288,"data":null}}}}}}},"/elaborato_planimetrico":{"post":{"tags":["Elaborato Planimetrico"],"summary":"Antrag auf Erstellung eines Katasterbauplans stellen","description":"Erstellt einen Antrag auf einen Kataster-Grundrissplan.\n\nÜberprüfen Sie den Status mit GET /elaborato_planimetrico/{id} und laden Sie das PDF mit GET /elaborato_planimetrico/{id}/documento herunter, sobald es verfügbar ist.\n","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BodyElaboratoPlanimetrico"},"example":{"provincia":"RM","comune":"ROMA","foglio":872,"particella":405}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ElaboratoPlanimetrico"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"endpoint":"elaborato_planimetrico","stato":"in_erogazione","callback":false,"parametri":{"foglio":872,"particella":405,"comune":"H501#ROMA#4#0","sezione":null,"provincia":"ROMA Territorio-RM","sezione_urbana":""},"documento":null,"esito":null,"timestamp":1655308768,"owner":"test@email.it","id":"62aa01e18c75fd55685d07b3"},"success":true,"message":"","error":null}}}},"402":{"description":"Zahlung erforderlich","content":{"application/json":{"example":{"success":false,"message":"billing Error message  . $checkout->message .  code  . $checkout->error","error":284,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"provincia not valid","error":364,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"example":{"success":false,"message":"comune required","error":365,"data":null}}}}}},"get":{"tags":["Elaborato Planimetrico"],"summary":"Ruft alle Anfragen ab","description":"Mit dieser Methode können Sie alle Anfragen zum Katasterbauplan einsehen.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ElaboratoPlanimetrico"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":[{"id":"628e41900e304d63044f857d","endpoint":"elaborato_planimetrico","stato":"in_erogazione","timestamp":1653490064,"owner":"test@email.it"},{"id":"628e40d77ee3b06fb03350ca","endpoint":"elaborato_planimetrico","stato":"in_lavorazione","timestamp":1653489879,"owner":"test@email.it"},{"id":"628e40d77ee3b06fb03350ca","endpoint":"elaborato_planimetrico","stato":"evasa","timestamp":1653489879,"owner":"test@email.it"}],"success":true,"message":"","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no elaborati planimetrici linked to this account","error":363,"data":null}}}}}}},"/elaborato_planimetrico/{id}":{"get":{"tags":["Elaborato Planimetrico"],"summary":"Auszug aus dem Katasterplan","description":"Hier können Sie die Details des Katasterbauplans einsehen, der durch die ID gekennzeichnet ist.","parameters":[{"name":"id","in":"path","description":"Kataster-Bauplan-ID","required":true,"schema":{"type":"string","example":"628e41900e304d63044f857d"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ElaboratoPlanimetrico"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer"}}},"example":{"data":{"endpoint":"elaborato_planimetrico","stato":"evasa","callback":false,"parametri":{"foglio":872,"particella":405,"comune":"H501#ROMA#4#0","sezione":null,"sezione_urbana":"","provincia":"ROMA Territorio-RM"},"documento":"628e41900e304d63044f857d.pdf","esito":"OK","timestamp":1653490064,"owner":"test@email.it","id":"628e41900e304d63044f857d"},"success":true,"message":"","error":null}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":286,"data":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no elaborato planimetrico found","error":371,"data":null}}}}}}},"/elaborato_planimetrico/{id}/documento":{"get":{"tags":["Elaborato Planimetrico"],"summary":"Katasterbauplan herunterladen","description":"Mit dieser Methode können Sie das Dokument direkt herunterladen","parameters":[{"name":"id","in":"path","description":"Kataster-Bauplan-ID","required":true,"schema":{"type":"string","example":"628e41900e304d63044f857d"}}],"responses":{"200":{"description":"Inhalt der Datei","content":{"application/PDF":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/json":{"example":{"success":false,"message":"Wrong id","error":286,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"example":{"success":false,"message":"document not yet available","error":288,"data":null}}}}}}},"/monitoraggio":{"get":{"tags":["Monitoraggio"],"summary":"Liste aller Anfragen","description":"Übersicht über alle Anfragen, die über Ihr Profil gestellt wurden","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MonitorRequest"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"example":{"data":[{"tipo_monitoraggio":"prospetto_catastale","parametri":{"tipo_catasto":"F","provincia":"ROMA Territorio-RM","comune":"H501#ROMA#0#0","sezione":null,"sezione_urbana":"","foglio":123,"particella":123,"subalterno":123},"data_ultima_verifica":"2026-06-22","data_prossima_verifica":"2026-06-29","data_scadenza":"2027-06-22","rinnovo_automatico":true,"esito":"OK","id":"6a390cf25748340e5c0d5885"},{"tipo_monitoraggio":"ricerca_persona_fisica","parametri":{"cf_piva":"RSSMRA85E28H501E","tipo_catasto":"TF","provincia":"TERNI Territorio-TR"},"data_ultima_verifica":"2026-06-22","data_prossima_verifica":"2026-06-29","data_scadenza":"2027-06-22","rinnovo_automatico":false,"esito":"OK","id":"6a3900515748340e5c0d587c"},{"tipo_monitoraggio":"ricerca_nazionale_pf","parametri":{"cf_piva":"RSSMRA85E28H501E","tipo_catasto":"T"},"data_ultima_verifica":null,"data_prossima_verifica":"2026-06-29","data_scadenza":"2027-06-22","rinnovo_automatico":true,"esito":"OK","id":"6a3900515748340e5c0d587d"}],"success":true,"message":"","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no monitoring requests related to your account","error":1200,"data":null}}}}}},"post":{"tags":["Monitoraggio"],"summary":"Überwachungsanfrage erstellen","description":"Über diesen Endpunkt können Sie eine neue Katasterüberwachungsanfrage erstellen. Wenn Sie einen Callback eingerichtet haben, werden Sie benachrichtigt, sobald die erste Überprüfung abgeschlossen ist und jedes Mal, wenn sich eines oder mehrere der überwachten Felder ändern.\n\nDie erste Überprüfung kann innerhalb weniger Sekunden abgeschlossen sein. Sollte das Ergebnis nicht sofort verfügbar sein, wird die Überwachungsanfrage automatisch weiterverarbeitet. Nachfolgende Überprüfungen finden alle 7 Tage statt für:<ul><li><strong>prospetto_catastale</strong></li><li><strong>ricerca_persona</strong></li><li><strong>ricerca_nazionale</strong></li></ul>\n\nWird <strong>rinnovo_automatico</strong> weggelassen, wird es auf <strong>true</strong> gesetzt.\n\nFür <strong>prospetto_catastale</strong> kann <strong>campi_monitorati</strong> weggelassen werden, um alle Felder zu überwachen, auf <strong>all</strong> gesetzt werden oder mit einem oder mehreren zulässigen Feldern gefüllt werden. Bei <strong>ricerca_persona</strong> und <strong>ricerca_nazionale</strong> werden die überwachten Felder immer als <strong>all</strong> gespeichert.\n\nDas Feld <strong>esito</strong> kann auch den Wert <strong>Nessun risultato trovato</strong> zurückgeben. Bei <strong>ricerca_persona</strong> und <strong>ricerca_nazionale</strong> werden <strong>ultimo_dataset</strong> und <strong>dataset_precedente</strong> als <strong>null</strong> zurückgegeben, wenn bei der ersten Überprüfung keine Daten zum Suchobjekt gefunden werden. Wurden bei einer vorherigen Überprüfung Daten gefunden und findet eine spätere Überprüfung keine zugehörigen Immobilien oder Katastereinträge mehr, bleibt <strong>esito</strong> auf <strong>Nessun risultato trovato</strong>; in diesem Fall behält der Datensatz die Objektstruktur bei, aber das Array <strong>immobili</strong> für <strong>ricerca_persona</strong> bzw. das Array <strong>catasti</strong> für <strong>ricerca_nazionale</strong> wird leer zurückgegeben. Für <strong>prospetto_catastale</strong> werden die Datensatzfelder als <strong>null</strong> zurückgegeben, wenn keine Daten gefunden werden.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorPayload"},"examples":{"prospetto_catastale":{"summary":"Katasterauszug","value":{"tipo_monitoraggio":"prospetto_catastale","tipo_catasto":"F","provincia":"RM","comune":"ROMA","foglio":123,"particella":123,"subalterno":123,"campi_monitorati":["rendita","classe","intestatari"],"rinnovo_automatico":true,"callback":{"url":"https://www.mysite.it/callback.php"}}},"ricerca_persona":{"summary":"Personensuche","value":{"tipo_monitoraggio":"ricerca_persona","cf_piva":"RSSMRA85E28H501E","tipo_catasto":"TF","provincia":"RM","rinnovo_automatico":false,"callback":{"url":"https://www.mysite.it/callback.php"}}},"ricerca_nazionale":{"summary":"nationale Forschung","value":{"tipo_monitoraggio":"ricerca_nazionale","cf_piva":"12485671007","tipo_catasto":"TF","callback":{"url":"https://www.mysite.it/callback.php"}}}}}}},"callbacks":{"callback":{"{$request.body#/callback/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MonitorRequest"},"custom":{"type":"object","nullable":true,"additionalProperties":true}}},"example":{"data":{"tipo_monitoraggio":"ricerca_nazionale_pg","campi_monitorati":["all"],"rinnovo_automatico":true,"callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"owner":"test@email.it","parametri":{"cf_piva":"12485671007","tipo_catasto":"TF","provincia":"NAZIONALE-IT"},"data_creazione":"2026-06-22","data_ultima_verifica":"2026-06-22","data_prossima_verifica":"2026-06-29","data_scadenza":"2027-06-22","esito":"OK","campi_aggiornati":{"soggetti":[{"denominazione":"ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA","sede":"ROMA (RM)","cf":"12485671007","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","catasti":[{"citta":"ROMA","fabbricati":1,"terreni":0,"comuni":[{"comune":"ROMA","fabbricati":1,"terreni":0}],"provincia":"RM"}]}]},"ultimo_dataset":{"soggetti":[{"denominazione":"ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA","sede":"ROMA (RM)","cf":"12485671007","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","catasti":[{"citta":"ROMA","fabbricati":1,"terreni":0,"comuni":[{"comune":"ROMA","fabbricati":1,"terreni":0}],"provincia":"RM"}]}]},"dataset_precedente":null,"id":"6a39525d5748340e5c0d5891"},"custom":null}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MonitorRequest"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"example":{"data":{"tipo_monitoraggio":"ricerca_nazionale_pg","campi_monitorati":["all"],"rinnovo_automatico":true,"callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"owner":"test@email.it","parametri":{"cf_piva":"12485671007","tipo_catasto":"TF","provincia":"NAZIONALE-IT"},"data_creazione":"2026-06-22","data_ultima_verifica":null,"data_prossima_verifica":"2026-06-29","data_scadenza":"2027-06-22","esito":null,"campi_aggiornati":null,"ultimo_dataset":null,"dataset_precedente":null,"id":"6a39525d5748340e5c0d5891"},"success":true,"message":"","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"tipo_monitoraggio not found; valid values: ricerca_persona, ricerca_nazionale, prospetto_catastale","error":1207,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"\"***\" is not an allowed field for prospetto_catastale (tipo_catasto=T); allowed fields: [\"zona_censuaria\",\"classe\",\"consistenza\",\"qualita\",\"ha\",\"are\",\"ca\",\"reddito_dominicale\",\"reddito_agrario\",\"partita\",\"intestatari\"]","error":1210,"data":null}}}}}}},"/monitoraggio/{id}":{"get":{"tags":["Monitoraggio"],"summary":"Konkrete Überwachungsanfrage abrufen","description":"Endpunkt, der die Überwachungsanfrage zurückgibt, die durch die im Pfad übergebene ID identifiziert wird.\n\nIn der Testumgebung können Sie den optionalen Abfrageparameter „callback“ verwenden, um die periodische Überprüfungsaktion, die normalerweise vom System-Cron ausgeführt wird, synchron zu simulieren. Auf diese Weise können Sie den Verifizierungsablauf testen und, sofern in der Überwachungsanfrage eine Callback-URL konfiguriert ist, die simulierte Callback-Antwort empfangen.","parameters":[{"name":"id","in":"path","description":"ID der Überwachungsanfrage","required":true,"schema":{"type":"string","example":"6a1234a2e60c4e3ad1234d19"}},{"name":"callback","in":"query","description":"Simuliert synchron die periodische Überprüfungsfunktion, die normalerweise vom System-Cron ausgeführt wird. Nur in der Testumgebung verfügbar.","required":false,"allowEmptyValue":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Erfolg","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/MonitorRequest"},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"examples":{"prospetto_catastale_F":{"summary":"Katasterauszug (F)","value":{"data":{"tipo_monitoraggio":"prospetto_catastale","rinnovo_automatico":true,"callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"campi_monitorati":["rendita"],"owner":"test@email.it","parametri":{"tipo_catasto":"F","provincia":"ROMA Territorio-RM","comune":"H501#ROMA#0#0","sezione":null,"sezione_urbana":"","foglio":123,"particella":123,"subalterno":123},"data_creazione":"2023-06-22","data_ultima_verifica":"2023-06-22","data_prossima_verifica":"2023-06-29","data_scadenza":"2024-06-22","esito":"OK","campi_aggiornati":{"rendita":"R.Euro:43,30"},"ultimo_dataset":{"immobili":[{"sezione_urbana":null,"foglio":123,"particella":123,"subalterno":123,"indirizzo":"VIA ROMA","sezione":null,"zona_censuaria":"","categoria":"C06","classe":"02","consistenza":"20  m2","rendita":"R.Euro:43,30","partita":"","id_immobile":"MTIzNDU2IzEyMzQ1NiNGIzEyMyMxMjMjSDUwMSMjMTIzIyAjUk9NQQ==","intestatari":[{"denominazione":"MARIO BIANCHI nato a ROMA (RM) il 28/05/1984","cf":"BNCMRA84E28H501E","proprieta":"Proprieta'","quota":"1/1"}]}]},"dataset_precedente":{"immobili":[{"sezione_urbana":"C","foglio":456,"particella":456,"subalterno":456,"indirizzo":"VIA MILANO","sezione":"C","zona_censuaria":"C","categoria":"A01","classe":"03","consistenza":"5,5 vani","rendita":"R.Euro:200,25","partita":"","id_immobile":"MTIzNDU2IzEyMzQ1NiNGIzEyMyMxMjMjSDUwMSMjMTIzIyAjUk9NQQ==","intestatari":[{"denominazione":"MARIO BIANCHI nato a ROMA (RM) il 28/05/1987","cf":"RSSMRA87E28H501E","proprieta":"Proprieta'","quota":"1/1"}]}]},"id":"6a1234a2e60c4e3ad1234d19"},"success":true,"message":"","error":null}},"prospetto_catastale_T":{"summary":"Katasterauszug (T)","value":{"data":{"tipo_monitoraggio":"prospetto_catastale","rinnovo_automatico":true,"callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"campi_monitorati":["classe","intestatari"],"owner":"test@email.it","parametri":{"tipo_catasto":"T","provincia":"ROMA Territorio-RM","comune":"H501#ROMA#0#0","sezione":null,"sezione_urbana":"","foglio":123,"particella":123,"subalterno":123},"data_creazione":"2023-06-22","data_ultima_verifica":"2023-06-22","data_prossima_verifica":"2023-06-29","data_scadenza":"2024-06-22","esito":"OK","campi_aggiornati":{"classe":"U","intestatari":[{"denominazione":"MARIO ROSSI nato a ROMA (RM) il 28/05/1984","cf":"RSSMRA84E28H501E","proprieta":"Proprieta'","quota":"1/2"},{"denominazione":"MARIO ROSSI nato a ROMA (RM) il 28/05/1985","cf":"RSSMRA85E28H501E","proprieta":"Proprieta'","quota":"1/2"}]},"ultimo_dataset":{"immobili":[{"sezione_urbana":null,"foglio":123,"particella":123,"subalterno":"","qualita":"BOSCO MISTO","classe":"U","ha":"0","are":"8","ca":"60","reddito_dominicale":"Euro: 0,55","reddito_agrario":"Euro: 0,17","partita":"","porzioni":"","id_immobile":"MTIzNDU2IzEyMzQ1NiNUIzEyMyMxMjMjSDUwMSMjIyAjUk9NQQ==","intestatari":[{"denominazione":"MARIO ROSSI nato a ROMA (RM) il 28/05/1984","cf":"RSSMRA84E28H501E","proprieta":"Proprieta'","quota":"1/2"},{"denominazione":"MARIO ROSSI nato a ROMA (RM) il 28/05/1985","cf":"RSSMRA85E28H501E","proprieta":"Proprieta'","quota":"1/2"}]}]},"dataset_precedente":{"immobili":[{"sezione_urbana":"C","foglio":456,"particella":456,"subalterno":"","qualita":"SEMINATIVO","classe":"2","ha":"1","are":"10","ca":"0","reddito_dominicale":"Euro: 10,16","reddito_agrario":"Euro: 7,13","partita":"0001813","porzioni":"","id_immobile":"MTIzNDU2IzEyMzQ1NiNUIzEyMyMxMjMjSDUwMSMjIyAjUk9NQQ==","intestatari":[{"denominazione":"MARIO BIANCHI nato a ROMA (RM) il 28/05/1984","cf":"BNCMRA84E28H501E","proprieta":"Proprieta'","quota":"1/2"},{"denominazione":"MARIO BIANCHI nato a ROMA (RM) il 28/05/1987","cf":"RSSMRA87E28H501E","proprieta":"Proprieta'","quota":"1/2"}]}]},"id":"6a1234a2e60c4e3ad1234d19"},"success":true,"message":"","error":null}},"ricerca_persona_fisica":{"summary":"Suche_nach_einer_natürlichen_Person","value":{"data":{"tipo_monitoraggio":"ricerca_persona_fisica","rinnovo_automatico":true,"callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"campi_monitorati":["all"],"owner":"test@email.it","parametri":{"cf_piva":"RSSMRA85E28H501E","tipo_catasto":"TF","provincia":"ROMA Territorio-RM"},"data_creazione":"2023-06-22","data_ultima_verifica":"2023-06-22","data_prossima_verifica":"2023-06-29","data_scadenza":"2024-06-22","esito":"OK","campi_aggiornati":{"soggetti":[{"cognome":"ROSSI","nome":"MARIO","data_nascita":"28/05/1985","luogo_nascita":"ROMA (RM)","sesso":"M","cf":"RSSMRA85E28H501E","id_soggetto":"OTIwMzAwNDk5IzAjUk9TU0kjTUFSSU8jUlNTTVJBODVFMjhINTAxRSNST01BIzI4LzA1LzE5ODUjUk0=","immobili":[{"sezione_urbana":null,"foglio":872,"particella":405,"subalterno":48,"sezione":null,"classe":"03","consistenza":"43  m2","rendita":"Euro: 133,25","id_immobile":"MTY1NjcyOCMxNjU2NzI4I0YjODcyIzQwNSNINTAxIzIyNTkyNjkjNDgjICNST01B","catasto":"F","titolarita":"Proprieta' per 1/1","ubicazione":"ROMA (RM) VIALE FILIPPO TOMMASO MARINETTI, SNC Piano 3 int. 6","comune":"ROMA","provincia":"RM","codice_catastale":"H501","classamento":"zona6 cat. A/10"}]}]},"ultimo_dataset":{"soggetti":[{"cognome":"ROSSI","nome":"MARIO","data_nascita":"28/05/1985","luogo_nascita":"ROMA (RM)","sesso":"M","cf":"RSSMRA85E28H501E","id_soggetto":"OTIwMzAwNDk5IzAjUk9TU0kjTUFSSU8jUlNTTVJBODVFMjhINTAxRSNST01BIzI4LzA1LzE5ODUjUk0=","immobili":[{"sezione_urbana":null,"foglio":872,"particella":405,"subalterno":48,"sezione":null,"classe":"03","consistenza":"43  m2","rendita":"Euro: 133,25","id_immobile":"MTY1NjcyOCMxNjU2NzI4I0YjODcyIzQwNSNINTAxIzIyNTkyNjkjNDgjICNST01B","catasto":"F","titolarita":"Proprieta' per 1/1","ubicazione":"ROMA (RM) VIALE FILIPPO TOMMASO MARINETTI, SNC Piano 3 int. 6","comune":"ROMA","provincia":"RM","codice_catastale":"H501","classamento":"zona6 cat. A/10"}]}]},"dataset_precedente":{"soggetti":[{"cognome":"ROSSI","nome":"MARIO","data_nascita":"28/05/1985","luogo_nascita":"ROMA (RM)","sesso":"M","cf":"RSSMRA85E28H501E","id_soggetto":"OTIwMzAwNDk5IzAjUk9TU0kjTUFSSU8jUlNTTVJBODVFMjhINTAxRSNST01BIzI4LzA1LzE5ODUjUk0=","immobili":[{"sezione_urbana":"C","foglio":456,"particella":456,"subalterno":456,"sezione":"C","classe":"02","consistenza":"23  m2","rendita":"Euro: 33,25","id_immobile":"MTY1NjcyOCMxNjU2NzI4I0YjODcyIzQwNSNINTAxIzIyNTkyNjkjNDgjICNST01B","catasto":"F","titolarita":"Proprieta' per 1/1","ubicazione":"ROMA (RM) VIA ROMA, SNC Piano 3 int. 6","comune":"ROMA","provincia":"RM","codice_catastale":"H501","classamento":"zona6 cat. A/10"}]}]},"id":"6a1234a2e60c4e3ad1234d20"},"success":true,"message":"","error":null}},"ricerca_persona_giuridica":{"summary":"Suche_nach_juristischer_Person","value":{"data":{"tipo_monitoraggio":"ricerca_persona_giuridica","rinnovo_automatico":true,"callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"campi_monitorati":["all"],"owner":"test@email.it","parametri":{"cf_piva":"12485671007","tipo_catasto":"TF","provincia":"ROMA Territorio-RM"},"data_creazione":"2023-06-22","data_ultima_verifica":"2023-06-22","data_prossima_verifica":"2023-06-29","data_scadenza":"2024-06-22","esito":"OK","campi_aggiornati":{"soggetti":[{"denominazione":"ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA","sede":"ROMA (RM)","cf":"12485671007","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","immobili":[{"sezione_urbana":null,"foglio":872,"particella":405,"subalterno":48,"sezione":null,"classe":"03","consistenza":"43  m2","rendita":"Euro: 133,25","id_immobile":"MTY1NjcyOCMxNjU2NzI4I0YjODcyIzQwNSNINTAxIzIyNTkyNjkjNDgjICNST01B","catasto":"F","titolarita":"Proprieta' per 1/1","ubicazione":"ROMA (RM) VIALE FILIPPO TOMMASO MARINETTI, SNC Piano 3 int. 6","comune":"ROMA","provincia":"RM","codice_catastale":"H501","classamento":"zona6 cat. A/10"}]}]},"ultimo_dataset":{"soggetti":[{"denominazione":"ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA","sede":"ROMA (RM)","cf":"12485671007","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","immobili":[{"sezione_urbana":null,"foglio":872,"particella":405,"subalterno":48,"sezione":null,"classe":"03","consistenza":"43  m2","rendita":"Euro: 133,25","id_immobile":"MTY1NjcyOCMxNjU2NzI4I0YjODcyIzQwNSNINTAxIzIyNTkyNjkjNDgjICNST01B","catasto":"F","titolarita":"Proprieta' per 1/1","ubicazione":"ROMA (RM) VIALE FILIPPO TOMMASO MARINETTI, SNC Piano 3 int. 6","comune":"ROMA","provincia":"RM","codice_catastale":"H501","classamento":"zona6 cat. A/10"}]}]},"dataset_precedente":{"soggetti":[{"denominazione":"ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA","sede":"ROMA (RM)","cf":"12485671007","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","immobili":[{"sezione_urbana":"C","foglio":123,"particella":123,"subalterno":123,"sezione":"C","classe":"02","consistenza":"22  m2","rendita":"Euro: 133,25","id_immobile":"MTY1NjcyOCMxNjU2NzI4I0YjODcyIzQwNSNINTAxIzIyNTkyNjkjNDgjICNST01B","catasto":"F","titolarita":"Proprieta' per 1/2","ubicazione":"ROMA (RM) VIA ROMA, SNC Piano 3 int. 6","comune":"ROMA","provincia":"RM","codice_catastale":"H501","classamento":"zona6 cat. A/10"}]}]},"id":"6a1234a2e60c4e3ad1234d21"},"success":true,"message":"","error":null}},"ricerca_nazionale_pf":{"summary":"ricerca_nazionale_pf","value":{"data":{"tipo_monitoraggio":"ricerca_nazionale_pf","rinnovo_automatico":true,"callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"campi_monitorati":["all"],"owner":"test@email.it","parametri":{"cf_piva":"RSSMRA87E28H501E","tipo_catasto":"TF","provincia":"NAZIONALE-IT"},"data_creazione":"2023-06-22","data_ultima_verifica":"2023-06-22","data_prossima_verifica":"2023-06-29","data_scadenza":"2024-06-22","esito":"OK","campi_aggiornati":{"soggetti":[{"cognome":"ROSSI","nome":"MARIO","data_nascita":"28/05/1985","luogo_nascita":"ROMA (RM)","sesso":"M","cf":"RSSMRI85E28H501E","id_soggetto":"OTIwMzAwNDk5IzAjUk9TU0kjTUFSSU8jUlNTTVJBODVFMjhINTAxRSNST01BIzI4LzA1LzE5ODUjUk0=","catasti":[{"citta":"ROMA","fabbricati":1,"terreni":0,"provincia":"RM","comuni":[{"comune":"ROMA","fabbricati":1,"terreni":0}]}]}]},"ultimo_dataset":{"soggetti":[{"cognome":"ROSSI","nome":"MARIO","data_nascita":"28/05/1985","luogo_nascita":"ROMA (RM)","sesso":"M","cf":"RSSMRI85E28H501E","id_soggetto":"OTIwMzAwNDk5IzAjUk9TU0kjTUFSSU8jUlNTTVJBODVFMjhINTAxRSNST01BIzI4LzA1LzE5ODUjUk0=","catasti":[{"citta":"ROMA","fabbricati":1,"terreni":0,"provincia":"RM","comuni":[{"comune":"ROMA","fabbricati":1,"terreni":0}]}]}]},"dataset_precedente":{"soggetti":[{"cognome":"ROSSI","nome":"MARIO","data_nascita":"28/05/1985","luogo_nascita":"ROMA (RM)","sesso":"M","cf":"RSSMRI85E28H501E","id_soggetto":"OTIwMzAwNDk5IzAjUk9TU0kjTUFSSU8jUlNTTVJBODVFMjhINTAxRSNST01BIzI4LzA1LzE5ODUjUk0=","catasti":[{"citta":"ROMA","fabbricati":2,"terreni":0,"provincia":"RM","comuni":[{"comune":"ROMA","fabbricati":2,"terreni":0}]}]}]},"id":"6a1234a2e60c4e3ad1234d22"},"success":true,"message":"","error":null}},"ricerca_nazionale_pg":{"summary":"ricerca_nazionale_pg","value":{"data":{"tipo_monitoraggio":"ricerca_nazionale_pg","rinnovo_automatico":true,"callback":{"method":"JSON","url":"https://www.mysite.it/callback.php","user_id":"","username":"","field":"data","headers":{},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"campi_monitorati":["all"],"owner":"test@email.it","parametri":{"cf_piva":"12485671007","tipo_catasto":"TF","provincia":"NAZIONALE-IT"},"data_creazione":"2023-06-22","data_ultima_verifica":null,"data_prossima_verifica":"2023-06-29","data_scadenza":"2024-06-22","esito":"OK","campi_aggiornati":{"soggetti":[{"denominazione":"ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA","sede":"ROMA (RM)","cf":"12485671007","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","catasti":[{"citta":"ROMA","fabbricati":1,"terreni":0,"provincia":"RM","comuni":[{"comune":"ROMA","fabbricati":1,"terreni":0}]}]}]},"ultimo_dataset":{"soggetti":[{"denominazione":"ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA","sede":"ROMA (RM)","cf":"12485671007","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","catasti":[{"citta":"ROMA","fabbricati":1,"terreni":0,"provincia":"RM","comuni":[{"comune":"ROMA","fabbricati":1,"terreni":0}]}]}]},"dataset_precedente":{"soggetti":[{"denominazione":"ALTRAVIA SERVIZI SOCIETA' A RESPONSABILITA' LIMITATA","sede":"ROMA (RM)","cf":"12485671007","id_soggetto":"OTgwMzI3NTA1MiMwI0FMVFJBVklBIFNFUlZJWkkgU09DSUVUQScgQSBSRVNQT05TQUJJTElUQScgTElNSVRBVEEjUk9NQSAoUk0pIzEyNDg1NjcxMDA3","catasti":[{"citta":"ROMA","fabbricati":2,"terreni":0,"provincia":"RM","comuni":[{"comune":"ROMA","fabbricati":2,"terreni":0}]}]}]},"id":"6a1234a2e60c4e3ad1234d23"},"success":true,"message":"","error":null}}}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no monitoring request matches this id: 66c881896de559cb65055393","error":1202,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"id not valid","error":1201,"data":null}}}}}},"delete":{"tags":["Monitoraggio"],"summary":"Löschanfragen-Monitor","description":"Über diesen Endpunkt können Sie eine Überwachung in Catasto löschen.","parameters":[{"name":"id","in":"path","description":"Anfrage-ID","required":true,"schema":{"type":"string","example":"68d552b647587376560a41d2"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"string"}},"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"integer","nullable":true}}},"example":{"data":[],"success":true,"message":"1 deleted monitor","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"no monitoring request matches this id: 60d1bfc731177b0a092cdfc2","error":1205,"data":null}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"example":{"success":false,"message":"id not valid","error":1204,"data":null}}}},"428":{"description":"Voraussetzung erforderlich","content":{"application/json":{"example":{"success":false,"message":"id required","error":1203,"data":null}}}}}}}},"externalDocs":{"description":"Zum ersten Mal hier? Erstellen Sie einen neuen Zugriffstoken.","url":"https://console.openapi.com/de/oauth"},"security":[{"bearerAuth":[]}]}