{"openapi":"3.0.3","info":{"description":"Migliora l'affidabilità e la sicurezza della tua piattaforma con la suite completa di API per la convalida e l'identità di TRUST. Offre una convalida immediata e accurata di indirizzi e-mail, numeri di telefono, URL, indirizzi IP e IBAN, garantendo che i dati dei tuoi utenti siano puliti e utilizzabili fin dal primo giorno. Tutti gli endpoint utilizzano un sistema di code asincrono solido e tollerante ai guasti: invia la tua richiesta e ricevi gli aggiornamenti tramite webhook (callback) o semplicemente interroga la risorsa. La suite include inoltre una solida funzione di verifica dell’identità e dei documenti che offre verifiche automatizzate basate sull’intelligenza artificiale.","version":"3.0.3","title":"Trust Validation & Identity API","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://trust.openapi.com","description":"Produzione"},{"url":"https://test.trust.openapi.com","description":"Sandbox"}],"tags":[{"name":"HLR","description":"Richiesta \"Home Location Register\" per la convalida dei numeri di cellulare"},{"name":"Email","description":"Servizi di verifica degli indirizzi e-mail"},{"name":"IP & Proxy","description":"Servizi di verifica degli indirizzi IP e di rilevamento dei proxy"},{"name":"URL","description":"Servizi di scansione degli URL e di analisi delle minacce"},{"name":"Identity Verification","description":"Servizi di verifica dell'identità"},{"name":"IBAN Verification","description":"Servizi di convalida dell'IBAN, estrazione delle coordinate bancarie e verifica della raggiungibilità SEPA"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"skipParam":{"name":"skip","in":"query","description":"Numero di record da saltare per l'impaginazione.","required":false,"schema":{"type":"integer","default":0}},"limitParam":{"name":"limit","in":"query","description":"Numero massimo di record da restituire (max 100).","required":false,"schema":{"type":"integer","default":100,"maximum":100}},"stateQueryParam":{"name":"state","in":"query","description":"Filtra i risultati in base al loro stato di elaborazione.","required":false,"schema":{"type":"string","enum":["NEW","WAIT","DONE"]}}},"schemas":{"Callback":{"type":"object","description":"Questo è il nostro sistema standardizzato di callback OpenAPI. Consente di configurare i parametri per ricevere notifiche relative agli aggiornamenti di stato delle richieste asincrone inviate a questo endpoint.","required":["url"],"properties":{"method":{"type":"string","description":"Specificare il metodo di callback. Se impostato su 'POST', verrà avviata una richiesta HTTP POST standard con l'intestazione Content-Type impostata su application/x-www-form-urlencoded. I dati JSON verranno codificati in una coppia chiave-valore denominata \"data\" (personalizzabile tramite il parametro \"field\") all'interno del corpo della richiesta. Se il metodo è impostato su \"JSON\", verrà effettuata una richiesta HTTP POST diretta con l'intestazione Content-Type impostata su application/json. I dati JSON grezzi verranno inseriti direttamente nel corpo della richiesta senza alcuna codifica.","enum":["POST","JSON"],"default":"JSON"},"field":{"type":"string","description":"Questo parametro funziona in combinazione con il parametro \"method\" impostato su \"POST\". Se specificato come stringa, determina il nome del parametro che verrà inviato nella richiesta POST.","example":"data","default":"data"},"url":{"type":"string","format":"uri","description":"In questo parametro deve essere inserito un URL valido in grado di gestire le richieste POST. Per gli endpoint che richiedono l'autenticazione, è possibile utilizzare il parametro \"headers\" per specificare \"basic auth\" o \"bearer auth\". Il timeout massimo è di 30 secondi. Se «retry» è impostato, il sistema effettuerà un massimo di «retry» tentativi fino a quando non verrà ricevuto un codice di stato 200.","example":"https://www.mysite.com/myEndpoint"},"retry":{"type":"integer","description":"Il numero massimo di tentativi è definito dal parametro “retry”. Se si raggiunge il numero massimo di tentativi senza ottenere un codice di stato positivo (ad esempio, 200 OK), la richiesta viene considerata un fallimento definitivo. Spesso viene introdotto un intervallo di tempo tra un tentativo e l’altro per evitare di sovraccaricare il server. Tale intervallo può aumentare in modo esponenziale a ogni tentativo per ridurre l’impatto su un server sovraccarico. Il parametro \"retry\" è configurato per riprovare la richiesta solo in caso di codici di stato specifici, in genere quelli che indicano errori temporanei (ad es. 502, 503) o problemi di rete.","example":3,"minimum":0,"maximum":5,"default":0},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"Un insieme di intestazioni HTTP da inviare insieme alla richiesta. Ogni intestazione è definita come una coppia chiave-valore. Le intestazioni possono essere utilizzate per vari scopi, tra cui l'autenticazione, la negoziazione dei contenuti e i metadati personalizzati.","example":{"session_id":"9834r5fh589494"}},"custom":{"type":"object","description":"Questo oggetto può essere popolato con qualsiasi dato aggiuntivo che desideri includere nella risposta della callback. Questi dati saranno accessibili tramite il parametro \"custom\" della funzione di callback. Puoi utilizzarlo per memorizzare e recuperare qualsiasi informazione rilevante necessaria per la tua applicazione.","example":{"my_custom_id":"123456789"}}}},"GenericResponseWrapper":{"type":"object","properties":{"success":{"type":"boolean","example":true},"message":{"type":"string","example":"Success"},"error":{"type":"string","nullable":true,"example":null}}},"mobile-start":{"type":"object","properties":{"id":{"type":"string","example":"66d9e92216065fa37f3c9841"},"state":{"type":"string","enum":["NEW","WAIT","DONE"],"description":"Definisce lo stato della richiesta. \"DONE\" indica che il controllo della rete HLR è stato completato.","example":"DONE"},"status":{"type":"string","enum":["valid","invalid","unknown"],"description":"La validità EFFETTIVA del numero di telefono nella rete, verificata tramite la ricerca nell'HLR. Questo è il parametro definitivo per verificare se il numero esiste ed è attivo. Rimarrà \"sconosciuto\" finché lo \"stato\" non diventerà \"COMPLETATO\".","example":"valid"},"requestedNumber":{"type":"string","example":"00393939989747"},"formattedNumber":{"type":"string","example":"+393939989747"},"numberType":{"type":"string","example":"MOBILE"},"isPossible":{"type":"boolean","description":"[SOLO VERIFICA FORMALE] Indica se la lunghezza del numero e il prefisso sono teoricamente possibili per quella regione. Ciò NON significa che il numero esista effettivamente.","example":true},"isValid":{"type":"boolean","description":"[SOLO CONTROLLO FORMALE] Indica se il numero è conforme alla sintassi corretta/all'espressione regolare (RegEx) prevista per la regione. ATTENZIONE: un numero può avere il valore \"isValid: true\" ma essere in realtà disattivato o inesistente. Per una verifica effettiva della rete, fare riferimento al campo \"status\".","example":true},"regionCode":{"type":"string","example":"IT"},"isValidNumberForRegion":{"type":"boolean","example":true},"network":{"type":"string","example":"MNO - Vodafone Italy"},"originalNetwork":{"type":"string","example":"MNO - TIM"},"roaming":{"type":"boolean","example":false},"ported":{"type":"boolean","example":true},"country":{"type":"string","example":"Italy"},"countryPrefix":{"type":"string","example":"39"},"details":{"type":"string","description":"Ulteriori dettagli sulla rete forniti dal gestore (ad es. DELIVERED_TO_HANDSET).","example":"DELIVERED_TO_HANDSET"},"createdAt":{"type":"string","format":"date-time","example":"2026-06-08T10:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-06-08T10:00:05Z"}}},"email-start":{"type":"object","properties":{"id":{"type":"string","description":"Identificatore univoco della richiesta di convalida, restituito al momento della creazione della richiesta.","example":"eml_77e9e92216065fa37f3c9842","readOnly":true},"state":{"type":"string","description":"Stato di elaborazione della richiesta di convalida. \"DONE\" indica che la convalida è stata completata e che i risultati sono disponibili.","enum":["NEW","WAIT","DONE"],"example":"DONE"},"requestedEmail":{"type":"string","format":"email","description":"L'indirizzo e-mail originale fornito dal cliente nella richiesta.","example":" Test.User@EXAMPLE.COM "},"email":{"type":"string","format":"email","description":"L'indirizzo e-mail che è stato elaborato, eventualmente dopo una prima pulizia (ad esempio, la rimozione degli spazi).","example":"Test.User@EXAMPLE.COM"},"emailNormalized":{"type":"string","format":"email","description":"La versione normalizzata dell'indirizzo e-mail utilizzata per la convalida (ad esempio, in minuscolo).","example":"test.user@example.com"},"status":{"type":"string","description":"Lo stato di convalida complessivo dell'indirizzo e-mail. Se l'indirizzo e-mail ha un ruolo, è protetto da antispam, è un indirizzo usa e getta o di tipo catchAll, lo stato sarà sempre considerato a rischio. Lo stato \"non valido\" verrà restituito solo se l'indirizzo è tecnicamente non valido (formato errato, dominio/indirizzo inesistente o in casi quali il greylisting). Infine, lo stato “sconosciuto” verrà restituito quando il provider del server remoto non ha risposto in tempo ","enum":["valid","invalid","risky","unknown"],"example":"valid"},"validSpf":{"type":"boolean","description":"Indica se il record SPF del dominio è valido e se consente l'invio di posta dai server di posta rilevati.","example":true},"spfDetails":{"$ref":"#/components/schemas/SpfDetails"},"validDmarc":{"type":"boolean","description":"Indica se il dominio dispone di un record DMARC valido e se la politica è rispettata.","example":true},"dmarcDetails":{"$ref":"#/components/schemas/DmarcDetails"},"details":{"type":"string","description":"Un codice o un messaggio più specifico che descriva in dettaglio lo stato secondario della convalida (ad esempio, \"mailbox_valid\", \"domain_invalid\", \"smtp_error\").","example":"mailbox_valid","nullable":true},"free":{"type":"boolean","description":"Indica se l'indirizzo e-mail appartiene a un provider di posta elettronica gratuito (ad es. Gmail, Outlook.com).","example":true},"role":{"type":"boolean","description":"Indica se l'indirizzo e-mail è un account associato a un ruolo (ad es., admin@, support@, info@).","example":false},"disposable":{"type":"boolean","description":"Indica se l'indirizzo e-mail proviene da un provider di indirizzi e-mail usa e getta noto.","example":false},"catchAll":{"type":"boolean","description":"Indica se il dominio di posta elettronica è configurato come \"catch-all\".","example":false,"nullable":true},"hasAntispam":{"type":"boolean","description":"Indica se il server di posta del dominio dispone di sistemi antispam riconosciuti.","example":true,"nullable":true},"mailboxFull":{"type":"boolean","description":"Indica se la casella di posta risulta piena (se è possibile stabilirlo).","example":false,"nullable":true},"didYouMean":{"type":"string","format":"email","description":"Una correzione suggerita nel caso in cui venga rilevato un errore di battitura comune nel dominio dell'e-mail.","example":"user@gmail.com","nullable":true},"createdAt":{"type":"string","format":"date-time","description":"Data e ora di creazione della richiesta di convalida.","example":"2025-05-27T10:00:00Z","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Data e ora dell'ultimo aggiornamento della richiesta di convalida.","example":"2025-05-27T10:00:05Z","readOnly":true}}},"SpfFormalValidity":{"type":"object","description":"Dettagli sulla validità formale del record SPF.","properties":{"startsWithVspf1":{"type":"boolean","description":"Indica se il record inizia con \"v=spf1\"."},"hasValidAllMechanism":{"type":"boolean","description":"Indica se è presente un meccanismo \"all\" valido."},"dnsMechanismLookupCount":{"type":"integer","description":"Conteggio delle ricerche DNS per i meccanismi."},"maxDnsMechanismLookups":{"type":"integer","description":"Numero massimo consentito di ricerche DNS per i meccanismi."},"voidLookupCount":{"type":"integer","description":"Conteggio delle ricerche DNS non riuscite."},"maxVoidLookups":{"type":"integer","description":"Numero massimo consentito di ricerche DNS senza risultato."},"hasRedirectModifier":{"type":"boolean","description":"Indica se è presente un modificatore \"redirect\"."},"redirectDomain":{"type":"string","nullable":true,"description":"Dominio specificato nel modificatore \"redirect\".","example":"_spf.example.com"},"syntaxErrors":{"type":"array","items":{"type":"string"},"description":"Elenco degli errori di sintassi rilevati.","example":["Unknown mechanism: xyz"]},"warnings":{"type":"array","items":{"type":"string"},"description":"Elenco delle segnalazioni generate durante l'analisi.","example":["PTR mechanism used, which is discouraged."]},"explanationDomain":{"type":"string","nullable":true,"description":"Dominio specificato nel modificatore \"exp\".","example":"exp.example.com"}}},"SpfMechanism":{"type":"object","description":"Dettagli relativi a un meccanismo SPF analizzato. La struttura può variare a seconda del tipo di meccanismo.","properties":{"term":{"type":"string","description":"Il termine originale relativo al meccanismo.","example":"+mx"},"mechanism":{"type":"string","description":"The type of mechanism (ad esempio, \"ip4\", \"include\", \"a\").","example":"mx"},"value":{"type":"string","nullable":true,"description":"Il valore associato al meccanismo.","example":"mail.example.com"},"qualifier":{"type":"string","description":"Il qualificatore del meccanismo (+, -, ~, ?).","example":"+"},"lookupCost":{"type":"integer","description":"Il costo della ricerca DNS associato al meccanismo.","example":1},"isVoidLookup":{"type":"boolean","description":"Indica se questo meccanismo ha dato luogo a una ricerca non valida."},"ipsFound":{"type":"array","items":{"type":"string"},"description":"Indirizzi IP individuati specificatamente tramite questo meccanismo.","example":["192.0.2.1","2001:db8::1"]},"effectiveResultIfMatched":{"type":"string","description":"Il risultato SPF nel caso in cui questo meccanismo dovesse corrispondere (PASS, FAIL, ecc.).","example":"PASS"},"includedReport":{"$ref":"#/components/schemas/SpfDetails"},"redirectedReport":{"$ref":"#/components/schemas/SpfDetails"}},"additionalProperties":true},"SpfAllMechanismDetails":{"type":"object","nullable":true,"description":"Dettagli sul meccanismo \"all\", se presente.","properties":{"term":{"type":"string","example":"-all"},"qualifier":{"type":"string","example":"-"},"result":{"type":"string","example":"FAIL"}}},"SpfCollectedIpAddresses":{"type":"object","description":"Indirizzi IP raccolti durante l'analisi SPF.","properties":{"ip4":{"type":"array","items":{"type":"string"},"example":["192.0.2.0/24"]},"ip6":{"type":"array","items":{"type":"string"},"example":["2001:db8:1234::/48"]},"fromA":{"type":"array","items":{"type":"string"},"example":["203.0.113.5"]},"fromMx":{"type":"array","items":{"type":"string"},"example":["203.0.113.10"]}}},"SpfSummary":{"type":"object","description":"Sintesi dell'analisi SPF.","properties":{"totalDnsMechanismLookupsUsed":{"type":"integer","example":3},"finalProcessingResult":{"type":"string","description":"Risultato finale dell'elaborazione del record SPF (ad es., NEUTRAL, PERMERROR, NONE).","example":"FAIL"},"evaluationLog":{"type":"array","items":{"type":"string"},"example":["Mechanism 'mx' matched.","Mechanism '-all' encountered."]}}},"SpfDetails":{"type":"object","description":"Dettagli completi sull'analisi del record SPF.","properties":{"domain":{"type":"string","example":"example.com"},"dnsServerUsed":{"type":"string","nullable":true,"description":"Server DNS utilizzato per questa specifica analisi SPF.","example":"8.8.8.8"},"queriedDnsForTxt":{"type":"boolean"},"selectedSpfRecord":{"type":"string","nullable":true,"example":"v=spf1 mx -all"},"formalValidity":{"$ref":"#/components/schemas/SpfFormalValidity"},"parsedMechanisms":{"type":"array","items":{"$ref":"#/components/schemas/SpfMechanism"}},"allMechanismDetails":{"$ref":"#/components/schemas/SpfAllMechanismDetails"},"collectedIpAddresses":{"$ref":"#/components/schemas/SpfCollectedIpAddresses"},"summary":{"$ref":"#/components/schemas/SpfSummary"}}},"DmarcDetails":{"type":"object","description":"Dettagli completi sull'analisi del record DMARC.","properties":{"recordFound":{"type":"boolean"},"record":{"type":"string","nullable":true,"example":"v=DMARC1; p=reject; rua=mailto:dmarc@example.com"},"dnsQueryDomain":{"type":"string","example":"_dmarc.example.com"},"dnsServerUsed":{"type":"string","nullable":true,"description":"Server DNS utilizzato per questa specifica analisi DMARC.","example":"1.1.1.1"},"policy":{"type":"string","nullable":true,"enum":["none","quarantine","reject"],"example":"reject"},"subdomainPolicy":{"type":"string","nullable":true,"enum":["none","quarantine","reject"],"example":"none"},"alignmentDkim":{"type":"string","enum":["r","s"],"example":"r"},"alignmentSpf":{"type":"string","enum":["r","s"],"example":"r"},"percentage":{"type":"integer","example":100},"reportingUrisAggregate":{"type":"array","items":{"type":"string"},"example":["mailto:aggrep@example.com"]},"reportingUrisFailure":{"type":"array","items":{"type":"string"},"example":["mailto:authfail@example.com"]},"failureOptions":{"type":"array","items":{"type":"string"},"example":["0","1","d","s"]},"errors":{"type":"array","items":{"type":"string"},"example":["Invalid tag: xyz=abc"]},"warnings":{"type":"array","items":{"type":"string"},"example":["pct tag not found, defaulting to 100."]}}},"email-advanced":{"type":"object","properties":{"id":{"type":"string","description":"Identificatore univoco di questa richiesta di convalida.","example":"68824e7a933ef7b3a5017d38"},"email":{"type":"string","description":"L'indirizzo e-mail richiesto.","example":"example@gmail.com"},"spfDetails":{"$ref":"#/components/schemas/SpfDetails"},"dmarcDetails":{"$ref":"#/components/schemas/DmarcDetails"},"createdAt":{"type":"string","format":"date-time","description":"Data e ora di creazione della richiesta di convalida.","example":"2025-07-25T12:44:46+00:00"},"updatedAt":{"type":"string","format":"date-time","description":"Data e ora dell'ultimo aggiornamento della richiesta di convalida.","example":"2025-07-25T12:44:46+00:00"},"state":{"type":"string","description":"Stato di elaborazione della richiesta. \"DONE\" indica che l'elaborazione è terminata.","example":"DONE"},"message":{"type":"string","description":"Un messaggio di stato generico, solitamente \"Success.\", ma che può contenere altre informazioni relative all'elaborazione della richiesta o un avviso di errore di qualche tipo.","example":"Success."},"success":{"type":"boolean","description":"La richiesta di convalida è stata eseguita con successo?","example":true},"valid":{"type":"boolean","description":"Questo indirizzo e-mail sembra valido?","example":true},"disposable":{"type":"boolean","description":"Si sospetta che questa e-mail provenga da un servizio di posta temporanea o usa e getta? Solitamente associato a truffatori e malintenzionati.","example":false},"smtpScore":{"type":"integer","description":"Punteggio di validità della configurazione SMTP del server di posta elettronica. Intervallo: da -1 a 3. I punteggi superiori a -1 possono essere associati a un indirizzo e-mail valido. -1 = indirizzo e-mail non valido, 0 = il server di posta esiste, ma rifiuta tutti i messaggi, 1 = il server di posta esiste, ma presenta un errore temporaneo, 2 = il server di posta esiste e accetta tutti i messaggi, 3 = il server di posta esiste e ha verificato l'indirizzo e-mail.","example":3},"overallScore":{"type":"integer","description":"Punteggio complessivo di validità dell'indirizzo e-mail. Intervallo: da 0 a 4. I punteggi superiori a 1 possono essere associati a un indirizzo e-mail valido. 0 = indirizzo e-mail non valido, 1 = DNS valido, server di posta irraggiungibile, 2 = DNS valido, errore temporaneo di rifiuto della posta, 3 = DNS valido, accetta tutta la posta, 4 = DNS valido, esistenza dell'indirizzo e-mail verificata.","example":4},"firstName":{"type":"string","description":"Nome presumibile basato sull'indirizzo e-mail. Restituisce \"CORPORATE\" se si sospetta che l'indirizzo e-mail sia un indirizzo aziendale generico. Restituisce \"UNKNOWN\" se non è stato possibile determinare il nome.","example":"UNKNOWN"},"generic":{"type":"boolean","description":"Si sospetta che questo indirizzo e-mail sia un indirizzo generico o condiviso per un dominio? (ad es., “admin@”, “webmaster@”, “newsletter@”, “sales@”, “contact@”, ecc.)","example":false},"common":{"type":"boolean","description":"Questa e-mail proviene da uno dei comuni provider di posta elettronica gratuiti? (ad es. \"gmail.com\", \"yahoo.com\", \"hotmail.com\", ecc.)","example":true},"dnsValid":{"type":"boolean","description":"Il nome host dell'indirizzo e-mail dispone di voci DNS valide? Questo è un indizio parziale della validità dell'indirizzo e-mail.","example":true},"honeypot":{"type":"boolean","description":"Si ritiene che questo indirizzo e-mail sia un “honeypot” o una “trappola antispam”? L’invio di e-mail di massa a questi indirizzi aumenta il rischio di essere inseriti nella lista nera dei principali ISP e di finire nella cartella dello spam.","example":false},"deliverability":{"type":"string","description":"Con quale probabilità questa e-mail verrà recapitata all'utente e arriverà nella sua casella di posta? I valori possono essere \"alto\", \"medio\" o \"basso\".","example":"high"},"frequentComplainer":{"type":"boolean","description":"Indica se questo indirizzo e-mail si disiscrive spesso dalle mailing list di marketing o Reporta casi di spam.","example":false},"spamTrapScore":{"type":"string","description":"Livello di affidabilità stimato relativo alla possibilità che l'indirizzo e-mail sia una trappola antispam attiva. I valori possono essere \"alto\", \"medio\", \"basso\" o \"nessuno\". Si consiglia di eliminare gli indirizzi e-mail con stato \"alto\", in genere quelli utilizzati per invii promozionali. Questi dati hanno lo scopo di fornire un risultato più accurato per i punti dati \"frequentComplainer\" e \"honeypot\".","example":"none"},"catchAll":{"type":"boolean","description":"È probabile che questa e-mail sia un indirizzo “catch-all”, ovvero che il server di posta verifichi come validi tutti i messaggi inviati a tale indirizzo? In questi casi è difficile stabilire se l’indirizzo sia effettivamente valido, poiché il server di posta non conferma lo stato dell’account.","example":false},"timedOut":{"type":"boolean","description":"Il collegamento per la verifica via e-mail con il provider di posta elettronica è scaduto durante la verifica? Le ricerche che scadono con un risultato “valido” pari a falso sono molto probabilmente false e non dovrebbero essere considerate attendibili.","example":false},"suspect":{"type":"boolean","description":"Questo valore indica se il server di posta sta attualmente restituendo un ERROR temporaneo o se il sistema di verifica dell'indirizzo e-mail non è in grado di verificare l'indirizzo a causa di un handshake SMTP non riuscito. Questo stato sarà vero anche per gli indirizzi e-mail di tipo “catch-all”. Se questo valore è vero, si sospetta che il risultato “valido” possa essere inaffidabile e non vi è alcuna garanzia che l’indirizzo e-mail sia effettivamente valido.","example":false},"recentAbuse":{"type":"boolean","description":"Questo valore indicherà se sono stati rilevati casi di abuso verificati di recente relativi a questo indirizzo e-mail. Per \"abuso\" si intende un chargeback confermato, una registrazione fraudolenta, un dispositivo compromesso, un'installazione fraudolenta di un'app o comportamenti dannosi simili verificatisi negli ultimi giorni.","example":false},"fraudScore":{"type":"integer","description":"Il punteggio di frode complessivo dell'utente, calcolato in base alla reputazione dell'indirizzo e-mail e al comportamento recente. I punteggi di frode >= 75 sono considerati sospetti, ma non necessariamente indicativi di frode.","example":0},"suggestedDomain":{"type":"string","description":"Il valore predefinito è \"N/A\". Indica se il dominio di questo indirizzo e-mail debba essere effettivamente corretto in quello di un servizio di posta elettronica diffuso. Questo campo è utile per individuare gli errori di digitazione degli utenti. Ad esempio, per un indirizzo e-mail contenente \"gmai.com\", verrebbe suggerito il dominio \"gmail.com\".","example":"N/A"},"leaked":{"type":"boolean","description":"Questo indirizzo e-mail era associato a una recente fuga di dati da un database di terze parti? Gli account oggetto di fuga di dati rappresentano un rischio, poiché potrebbero essere stati compromessi durante una violazione del database.","example":false},"sanitizedEmail":{"type":"string","description":"Indirizzo e-mail ripulito, con tutti gli alias e gli elementi di mascheramento rimossi, come ad esempio i punti multipli nel caso di Gmail.com.","example":"example@gmail.com"},"identityData":{"type":"string","description":"Un oggetto contenente informazioni di identificazione arricchite, provenienti da fonti di dati altamente attendibili. Arricchisce nome, età e relativi indirizzi e-mail, numeri di telefono e indirizzi fisici. Ogni voce rappresenta una persona. Ogni campo può restituire più valori.","nullable":true},"domainAge":{"type":"object","properties":{"human":{"type":"string","example":"30 years ago"},"timestamp":{"type":"integer","example":808286400},"iso":{"type":"string","example":"1995-08-13T00:00:00-04:00"}},"description":"Un oggetto contenente l'età del dominio in un formato di facile comprensione, oltre alla data e al timestamp corrispondenti in formato ISO 8601."},"firstSeen":{"type":"object","properties":{"human":{"type":"string","example":"2 years ago"},"timestamp":{"type":"integer","example":1706083391},"iso":{"type":"string","example":"2024-01-24T03:03:11-05:00"}},"description":"Un oggetto contenente l'ora in cui questa e-mail è stata rilevata per la prima volta dalla rete in un formato di facile comprensione per l'utente, nonché la data e il timestamp corrispondenti in formato ISO 8601."},"riskyTld":{"type":"boolean","description":"Indica che il dominio appartiene a un’estensione TLD a rischio, spesso associata a malware, truffe, abusi o phishing.","example":false},"spfRecord":{"type":"boolean","description":"Il dominio dispone di un record SPF valido? (vero/falso) Ciò indica che il dominio dispone di un record SPF valido, il che è un buon segno della sua legittimità.","example":true},"dmarcRecord":{"type":"boolean","description":"Il dominio dispone di un record DMARC valido? (vero/falso) Ciò indica che il dominio dispone di un record DMARC valido, il che è un buon segno che si tratti di un dominio legittimo.","example":true},"mxRecords":{"type":"array","description":"Elenco dei record MX associati al nome di dominio dell'indirizzo e-mail.","items":{"type":"string"}},"aRecords":{"type":"array","description":"Elenco dei record A associati al nome di dominio dell'indirizzo e-mail.","items":{"type":"string"}},"errors":{"type":"array","description":"Una serie di errori verificatisi durante il tentativo di elaborare questa richiesta.","items":{}}}},"ip-advanced":{"type":"object","properties":{"id":{"type":"string","description":"","example":"68838421827e938c9a0f53e6"},"ip":{"type":"string","description":"","example":"142.251.209.46"},"createdAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T13:18:25+00:00"},"updatedAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T13:18:25+00:00"},"state":{"type":"string","description":"","example":"DONE"},"requestedIp":{"type":"string"},"message":{"type":"string","description":"Messaggio che descrive il risultato della chiamata all'API.","example":"Success"},"success":{"type":"boolean","description":"La chiamata all'API è andata a buon fine?","example":true},"proxy":{"type":"boolean","description":"Questo indirizzo IP è un proxy? (SOCKS, Elite, Anonymous, VPN, TOR, ecc.)","example":false},"host":{"type":"string","description":"Nome host dell'indirizzo IP, se disponibile.","example":"mil04s51-in-f14.1e100.net"},"isp":{"type":"string","description":"Provider di servizi Internet associato all'indirizzo IP.","example":"-"},"organization":{"type":"string","description":"Struttura dell'indirizzo IP.","example":"Google Workspace"},"asn":{"type":"string","description":"Numero del sistema autonomo associato all'indirizzo IP.","example":"-"},"countryCode":{"type":"string","description":"Codice paese a due lettere dell'indirizzo IP.","example":"IT"},"city":{"type":"string","description":"Città associata all'indirizzo IP. In alcuni casi, potrebbe trattarsi della città principale più vicina.","example":"Milan"},"region":{"type":"string","description":"Regione o stato dell'indirizzo IP.","example":"Lombardia"},"timezone":{"type":"string","description":"Fuso orario della località associata all'indirizzo IP.","example":"Europe/Rome"},"latitude":{"type":"number","description":"Latitudine dell'indirizzo IP.","example":45.47000122},"longitude":{"type":"number","description":"Longitudine dell'indirizzo IP.","example":9.19999981},"zipCode":{"type":"string","description":"Codice postale o codice ZIP associato all'indirizzo IP.","example":"N/A"},"isCrawler":{"type":"boolean","description":"Questo indirizzo IP è associato a un crawler o a un bot di un motore di ricerca? (Google, Bing, Yandex, ecc.)","example":false},"connectionType":{"type":"string","description":"Classificazione del tipo di connessione dell'indirizzo IP. (Residenziale, Aziendale, Istruzione, Mobile, Data center)","example":"Data Center"},"recentAbuse":{"type":"boolean","description":"Questo indirizzo IP è stato associato a comportamenti abusivi recenti? Per \"abuso\" si intende, ad esempio, lo spam nei forum, i tentativi di accesso con forza bruta, la diffusione di malware, ecc.","example":false},"abuseVelocity":{"type":"string","description":"Con quale frequenza vengono segnalati abusi relativi a questo indirizzo IP dalla nostra rete di monitoraggio delle minacce? (alta, media, bassa, nessuna)","example":"none"},"botStatus":{"type":"boolean","description":"Questo indirizzo IP corrisponde a un bot noto? Questo valore viene aggiornato in tempo reale e può essere utilizzato per contrastare i bot e le frodi sui clic.","example":false},"frequentAbuser":{"type":"boolean"},"highRiskAttacks":{"type":"boolean"},"sharedConnection":{"type":"boolean"},"dynamicConnection":{"type":"boolean"},"securityScanner":{"type":"boolean"},"trustedNetwork":{"type":"boolean"},"operatingSystem":{"type":"string"},"browser":{"type":"string"},"deviceBrand":{"type":"string"},"deviceModel":{"type":"string"},"transactionDetails":{"type":"array","items":{}},"errors":{"type":"array","items":{}},"vpn":{"type":"boolean","description":"Questo indirizzo IP appartiene a una VPN? Ciò può includere sia VPN commerciali che private.","example":false},"tor":{"type":"boolean","description":"Questo indirizzo IP è un nodo di uscita di TOR?","example":false},"activeVpn":{"type":"boolean","description":"Questo indirizzo IP corrisponde attualmente a una connessione VPN attiva? Questa verifica viene effettuata in tempo reale ed è il metodo più accurato per individuare le connessioni VPN.","example":false},"activeTor":{"type":"boolean","description":"Questo indirizzo IP corrisponde attualmente a una connessione TOR attiva? Questa verifica viene effettuata in tempo reale ed è il metodo più accurato per individuare le connessioni TOR.","example":false},"mobile":{"type":"boolean","description":"Si tratta di una connessione mobile? (cellulare) Questo dato è utile per identificare gli utenti mobili.","example":false},"fraudScore":{"type":"integer","description":"Punteggio di frode relativo all'indirizzo IP. 0 indica il rischio più basso, mentre 100 indica il rischio più elevato.","example":0}}},"url-advanced":{"type":"object","properties":{"id":{"type":"string","description":"","example":"68837ffa535918d0da0a2856"},"url":{"type":"string","description":"","example":"www.openapi.com"},"createdAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T13:00:42+00:00"},"updatedAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T13:00:43+00:00"},"state":{"type":"string","description":"","example":"DONE"},"requestedUrl":{"type":"string","description":"","example":"www.openapi.com"},"message":{"type":"string","description":"Messaggio che descrive il risultato della chiamata all'API.","example":"Success."},"success":{"type":"boolean","description":"La chiamata all'API è andata a buon fine?","example":true},"unsafe":{"type":"boolean","description":"Si sospetta che questo URL sia dannoso o venga utilizzato per attività di phishing? Questo valore costituisce l'indicatore principale di un URL dannoso.","example":false},"domain":{"type":"string","description":"Dominio dell'URL finale dopo tutti i reindirizzamenti.","example":"openapi.com"},"ipAddress":{"type":"string","description":"L'indirizzo IP dell'host dell'URL. Questo valore risulterà N/A se non è stato possibile determinare l'indirizzo IP.","example":"N/A"},"countryCode":{"type":"string"},"languageCode":{"type":"string"},"server":{"type":"string"},"contentType":{"type":"string"},"statusCode":{"type":"integer","example":200},"pageSize":{"type":"integer","example":1024},"domainRank":{"type":"integer"},"dnsValid":{"type":"boolean"},"parking":{"type":"boolean"},"pageTitle":{"type":"string"},"shortLinkRedirect":{"type":"boolean"},"hostedContent":{"type":"boolean"},"riskyTld":{"type":"boolean"},"spfRecord":{"type":"boolean"},"dmarcRecord":{"type":"boolean"},"mxRecords":{"type":"array","items":{"type":"string"}},"nsRecords":{"type":"array","items":{"type":"string"}},"aRecords":{"type":"array","items":{"type":"string"}},"errors":{"type":"array","items":{}},"riskScore":{"type":"integer","description":"Il punteggio di rischio dell'URL, che stima la probabilità che l'URL sia dannoso. I punteggi di rischio pari o superiori a 85 indicano un rischio elevato.","example":86},"suspicious":{"type":"boolean","description":"Questo URL è ritenuto sospetto o rischioso? Questo valore è una versione più blanda del valore \"non sicuro\" e indica che l'URL potrebbe far parte di una campagna dannosa.","example":true},"phishing":{"type":"boolean","description":"Questo URL è collegato a una campagna di phishing? Gli URL di phishing vengono utilizzati per rubare dati sensibili degli utenti.","example":false},"malware":{"type":"boolean","description":"Questo URL è associato a malware o virus? Questi URL vengono utilizzati per infettare gli utenti con software dannoso.","example":false},"spamming":{"type":"boolean","description":"Questo URL è associato a attività di spamming? Questi URL vengono utilizzati in e-mail e messaggi indesiderati.","example":false},"adult":{"type":"boolean","description":"Questo URL è associato a contenuti per adulti?","example":false},"category":{"type":"string","description":"La categoria del contenuto dell'URL.","example":"Technology"},"technologies":{"type":"array","items":{"type":"string"},"description":"","example":["HTML5","CSS3"]},"domainAge":{"type":"object","properties":{"human":{"type":"string","example":"23 years ago"},"timestamp":{"type":"integer","example":1017170444},"iso":{"type":"string","example":"2002-03-26T14:20:44-05:00"}},"description":"Un oggetto contenente l'età del dominio in un formato di facile comprensione, oltre alla data e al timestamp corrispondenti in formato ISO 8601."},"redirected":{"type":"boolean","description":"Il link dell'utente è stato reindirizzato a un URL diverso?","example":true},"scannedUrl":{"type":"string","description":"","example":"http://www.openapi.com"},"finalUrl":{"type":"string","description":"","example":"https://openapi.com"}}},"mobile-advanced":{"type":"object","properties":{"id":{"type":"string","description":"","example":"68837adc827e938c9a0f53e0"},"requestedNumber":{"type":"string","description":"","example":"+393334567890"},"formattedNumber":{"type":"string","description":"Il numero di telefono nel formato locale.","example":"+393334567890"},"createdAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T12:38:52+00:00"},"updatedAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T12:38:52+00:00"},"state":{"type":"string","description":"","example":"DONE"},"message":{"type":"string","description":"Messaggio che descrive il risultato della chiamata all'API.","example":"Phone is valid."},"success":{"type":"boolean","description":"La chiamata all'API è andata a buon fine?","example":true},"valid":{"type":"boolean","description":"Questo numero di telefono è valido? (vero/falso)","example":true},"active":{"type":"boolean","description":"Questo numero di telefono è attivo e in servizio? Questo valore viene restituito quando alla richiesta viene passato il parametro \"active\".","example":true},"localFormat":{"type":"string","description":"Il numero di telefono formattato secondo lo standard locale.","example":"340 554 6935"},"fraudScore":{"type":"integer","description":"Il punteggio di frode associato al numero di telefono. 0 indica il rischio più basso, mentre 100 indica il rischio più elevato.","example":0},"recentAbuse":{"type":"boolean","description":"Questo numero di telefono è stato associato a recenti comportamenti abusivi? Tali comportamenti potrebbero includere spam nei forum, tentativi di accesso con forza bruta, account falsi, ecc.","example":false},"voip":{"type":"string","description":"Questo numero di telefono è un numero Voice over IP (VOIP)? (vero/falso) Può anche trattarsi di un oggetto contenente ulteriori dettagli.","example":"-"},"prepaid":{"type":"boolean","description":"Questo numero di telefono è un numero prepagato? (vero/falso) Ciò indica che il numero di telefono non è un numero con abbonamento.","example":false},"risky":{"type":"boolean","description":"Questo numero di telefono è considerato rischioso? (vero/falso) Ciò indica che il numero di telefono è probabilmente un numero temporaneo o usa e getta.","example":false},"name":{"type":"string","description":"Il nome della persona o dell'azienda associata al numero di telefono. Questo valore viene restituito solo quando nella richiesta viene specificato il parametro \"name\".","example":"N/A"},"identityData":{"type":"string"},"carrier":{"type":"string","description":"Il titolare del numero di telefono.","example":"VODAFONE"},"lineType":{"type":"string","description":"The type of the line for the phone number. (e.g. \"Cellular\", \"Fixed\", \"VOIP\", etc.)","example":"Wireless"},"country":{"type":"string","description":"Il Paese a cui appartiene il numero di telefono.","example":"IT"},"region":{"type":"string"},"city":{"type":"string","description":"La città a cui si riferisce il numero di telefono. In alcuni casi, potrebbe trattarsi della città principale più vicina.","example":"Rome"},"accurateCountryCode":{"type":"boolean"},"zipCode":{"type":"string"},"timezone":{"type":"string","description":"Il fuso orario della località a cui appartiene il numero di telefono.","example":"Europe/Rome"},"dialingCode":{"type":"integer","description":"Il prefisso internazionale del paese a cui appartiene il numero di telefono.","example":39},"doNotCall":{"type":"boolean","description":"Questo numero di telefono è iscritto nel registro nazionale \"Do Not Call\"? (vero/falso)","example":false},"leaked":{"type":"boolean","description":"Questo numero di telefono è stato divulgato a seguito di una violazione dei dati? (vero/falso) Ciò indica che il numero di telefono è stato compromesso a seguito di una violazione dei dati.","example":false},"spammer":{"type":"boolean","description":"Questo numero di telefono è associato a attività di spamming? (vero/falso) Ciò indica che il numero di telefono è stato segnalato per attività di spamming.","example":false},"activeStatus":{"type":"string"},"mcc":{"type":"string","description":"Prefisso nazionale del cellulare, se disponibile.","example":"222"},"mnc":{"type":"string","description":"Codice di rete mobile, se disponibile.","example":"10"},"transactionDetails":{"type":"array","items":{}},"errors":{"type":"array","items":{}}}},"phone-advanced":{"type":"object","properties":{"id":{"type":"string","description":"","example":"68837adc827e938c9a0f53e0"},"requestedNumber":{"type":"string","description":"","example":"+390612345678"},"formattedNumber":{"type":"string","description":"Il numero di telefono formattato secondo lo standard locale.","example":"+390612345678"},"createdAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T12:38:52+00:00"},"updatedAt":{"type":"string","format":"date-time","description":"","example":"2025-07-25T12:38:52+00:00"},"state":{"type":"string","description":"","example":"DONE"},"message":{"type":"string","description":"Messaggio che descrive il risultato della chiamata all'API.","example":"Phone is valid."},"success":{"type":"boolean","description":"La chiamata all'API è andata a buon fine?","example":true},"valid":{"type":"boolean","description":"Questo numero di telefono è valido? (vero/falso)","example":true},"active":{"type":"boolean","description":"Questo numero di telefono è attivo e in servizio? Questo valore viene restituito quando nella richiesta viene passato il parametro \"active\".","example":true},"localFormat":{"type":"string","description":"Il numero di telefono formattato secondo lo standard locale.","example":"06 12345678"},"fraudScore":{"type":"integer","description":"Il punteggio di frode associato al numero di telefono. 0 indica il rischio più basso, mentre 100 indica il rischio più alto.","example":0},"recentAbuse":{"type":"boolean","description":"Questo numero di telefono è stato collegato a recenti casi di abuso? Per abuso si intende, ad esempio, spam nei forum, tentativi di accesso con forza bruta, account falsi, ecc.","example":false},"voip":{"type":"string","description":"Questo numero di telefono è un numero Voice over IP (VOIP)? (vero/falso) Può trattarsi anche di un oggetto contenente ulteriori dettagli.","example":"-"},"prepaid":{"type":"boolean","description":"Questo numero di telefono è un numero prepagato? (vero/falso) Ciò indica che il numero di telefono non è un numero con abbonamento.","example":false},"risky":{"type":"boolean","description":"Questo numero di telefono è considerato a rischio? (vero/falso) Ciò indica che il numero di telefono è probabilmente un numero temporaneo o usa e getta.","example":false},"name":{"type":"string","description":"Il nome della persona o dell'azienda associata al numero di telefono. Questo valore viene restituito solo quando nella richiesta viene specificato il parametro \"name\".","example":"N/A"},"identityData":{"type":"string"},"carrier":{"type":"string","description":"Il gestore associato al numero di telefono.","example":"TELECOM ITALIA"},"lineType":{"type":"string","description":"The line type of the phone number. (e.g. \"Cellular\", \"Fixed\", \"VOIP\", etc.)","example":"Landline"},"country":{"type":"string","description":"Il Paese a cui appartiene il numero di telefono.","example":"IT"},"region":{"type":"string"},"city":{"type":"string","description":"La city a cui si riferisce il numero di telefono. In alcuni casi, potrebbe trattarsi della city più vicina di una certa importanza.","example":"Rome"},"accurateCountryCode":{"type":"boolean"},"zipCode":{"type":"string"},"timezone":{"type":"string","description":"Il fuso orario della località a cui corrisponde il numero di telefono.","example":"Europe/Rome"},"dialingCode":{"type":"integer","description":"Il prefisso internazionale del Paese a cui appartiene il numero di telefono.","example":39},"doNotCall":{"type":"boolean","description":"Questo numero di telefono è iscritto nel registro nazionale “Do Not Call”? (vero/falso)","example":false},"leaked":{"type":"boolean","description":"Questo numero di telefono è stato divulgato a seguito di una violazione dei dati? (vero/falso) Ciò indica che il numero di telefono è stato compromesso a seguito di una violazione dei dati.","example":false},"spammer":{"type":"boolean","description":"Questo numero di telefono è associato a attività di spamming? (vero/falso) Ciò indica che il numero di telefono è stato segnalato per attività di spamming.","example":false},"activeStatus":{"type":"string"},"mcc":{"type":"string","description":"Prefisso nazionale del cellulare, se disponibile.","example":"222"},"mnc":{"type":"string","description":"Codice di rete mobile, se disponibile.","example":"10"},"transactionDetails":{"type":"array","items":{}},"errors":{"type":"array","items":{}}}},"iban-start":{"type":"object","properties":{"id":{"type":"string","example":"69c117af962df6cee50c9525"},"iban":{"type":"string","example":"IT60X0306905020000000123456"},"state":{"type":"string","enum":["NEW","WAIT","DONE"],"example":"DONE"},"status":{"type":"string","example":"IBAN is valid"},"bankData":{"type":"object","properties":{"bic":{"type":"string","example":"TESTITMMXXX"},"bank":{"type":"string","example":"Banca Italiana Test S.p.A."},"branch":{"type":"string","example":"Roma Sede Centrale"},"address":{"type":"string","example":"Via del Corso, 123"},"city":{"type":"string","example":"Roma"},"state":{"type":"string","nullable":true,"example":"RM"},"zipCode":{"type":"string","example":"00186"},"country":{"type":"string","example":"ITALY"},"countryCode":{"type":"string","example":"IT"},"account":{"type":"string","example":"000000123456"},"bankCode":{"type":"string","example":"03069"},"branchCode":{"type":"string","example":"05020"}}},"sepaData":{"type":"object","properties":{"creditTransfer":{"type":"boolean","example":true},"directDebit":{"type":"boolean","example":true},"cor1":{"type":"boolean","example":true},"b2b":{"type":"boolean","example":true},"cardClearing":{"type":"boolean","example":false}}},"validations":{"type":"object","properties":{"chars":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN does not contain illegal characters"}}},"account":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"Account Number check digit is correct"}}},"iban":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN Check digit is correct"}}},"structure":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN structure is correct"}}},"length":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN Length is correct"}}},"countrySupport":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"Country supports IBAN standard"}}}}},"createdAt":{"type":"string","format":"date-time","example":"2026-03-30T10:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-03-30T10:00:00Z"}}},"iban-advanced":{"type":"object","properties":{"id":{"type":"string","example":"69c117af962df6cee50c9525"},"iban":{"type":"string","example":"IT60X0306905020000000123456"},"state":{"type":"string","enum":["NEW","WAIT","DONE"],"example":"DONE"},"status":{"type":"string","example":"IBAN is valid"},"bankData":{"type":"object","properties":{"bic":{"type":"string","example":"TESTITMMXXX"},"bank":{"type":"string","example":"Banca Italiana Test S.p.A."},"branch":{"type":"string","example":"Roma Sede Centrale"},"address":{"type":"string","example":"Via del Corso, 123"},"city":{"type":"string","example":"Roma"},"state":{"type":"string","nullable":true,"example":"RM"},"zipCode":{"type":"string","example":"00186"},"country":{"type":"string","example":"ITALY"},"countryCode":{"type":"string","example":"IT"},"account":{"type":"string","example":"000000123456"},"bankCode":{"type":"string","example":"03069"},"branchCode":{"type":"string","example":"05020"}}},"sepaData":{"type":"object","properties":{"creditTransfer":{"type":"boolean","example":true},"directDebit":{"type":"boolean","example":true},"cor1":{"type":"boolean","example":true},"b2b":{"type":"boolean","example":true},"cardClearing":{"type":"boolean","example":false}}},"validations":{"type":"object","properties":{"chars":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN does not contain illegal characters"}}},"account":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"Account Number check digit is correct"}}},"iban":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN Check digit is correct"}}},"structure":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN structure is correct"}}},"length":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"IBAN Length is correct"}}},"countrySupport":{"type":"object","properties":{"valid":{"type":"boolean","example":true},"message":{"type":"string","example":"Country supports IBAN standard"}}}}},"createdAt":{"type":"string","format":"date-time","example":"2026-03-30T10:00:00Z"},"updatedAt":{"type":"string","format":"date-time","example":"2026-03-30T10:00:00Z"}}},"iban-vop":{"type":"object","properties":{"id":{"type":"string","example":"69c117af962df6cee50c9525"},"iban":{"type":"string","example":"IT60X0542811101000000123456"},"name":{"type":"string","description":"Il nome del beneficiario per cui è stata richiesta la verifica.","example":"Mario Openapi"},"state":{"type":"string","enum":["NEW","WAIT","DONE"],"example":"DONE"},"vopResult":{"type":"string","description":"Risultato del controllo di verifica del beneficiario (VoP).\n- MATCH: Il nome del beneficiario corrisponde a quello del titolare del conto\n- CLOSE_MATCH: Il nome è molto simile a quello del titolare del conto\n- NO_MATCH: Il nome non corrisponde a quello del titolare del conto\n- NOT_APPLICABLE: La verifica VoP non è applicabile per questo IBAN\n- ERROR: Si è verificato un errore durante il processo di verifica","enum":["MATCH","CLOSE_MATCH","NO_MATCH","NOT_APPLICABLE","ERROR"],"example":"MATCH","nullable":true},"details":{"type":"object","description":"Informazioni dettagliate sul risultato della verifica della corrispondenza del beneficiario.","nullable":true,"properties":{"matchType":{"type":"string","description":"Specific code that indicates the type of match.","enum":["MTCH","CMTC","NMTC","NOAP"],"example":"MTCH","nullable":true},"ownerName":{"type":"string","description":"Il nome del titolare del conto REGISTERED, se disponibile e restituito dalla rete bancaria.","example":"MARIO OPENAPI","nullable":true},"iban":{"type":"string","description":"L'IBAN verificato.","example":"IT60X0542811101000000123456","nullable":true}}},"createdAt":{"type":"string","format":"date-time","example":"2026-08-10T12:43:45+00:00"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-10T13:48:54+00:00"}}},"idv-verification":{"type":"object","properties":{"id":{"type":"string","example":"6a7c4a4d1f679b745b09b484"},"state":{"type":"string","enum":["NEW","WAIT"],"description":"\"NEW\" quando viene creata la sessione. \"WAIT\" in attesa del completamento.","example":"WAIT"},"email":{"type":"string","format":"email","example":"example@openapi.com"},"name":{"type":"string","example":"Mario Openapi"},"redirectUrl":{"type":"string","example":"https://openapi.com"},"verificationUrl":{"type":"string","description":"URL a cui reindirizzare l'utente per effettuare la verifica. Scade tra 15 minuti. Se scaduto, lo stato sarà \"rifiutato\" e la procedura di verifica dell'identità (IDV) verrà chiusa con il dettaglio = \"applicant_never_started\"","example":"https://idv.checkout.com/21aef278-e68d-43bf-b12a-d63969d1dee6"},"status":{"type":"string","description":"Ad esempio: created, pending_redirection, capture_in_progress, checks_in_progress.","enum":["capture_in_progress","checks_in_progress","created","pending_redirection"],"example":"pending_redirection"},"details":{"type":"string","nullable":true,"description":"Fornisce ulteriori informazioni sullo stato (ad es. applicant_never_started)","example":null},"riskLabels":{"type":"array","items":{"type":"string"},"example":[]},"createdAt":{"type":"string","format":"date-time","example":"2026-08-12T10:26:21+00:00"},"updatedAt":{"type":"string","format":"date-time","example":"2026-08-12T10:28:20+00:00"}}},"idv-verification-done":{"type":"object","properties":{"id":{"type":"string","example":"6a7c4a4d1f679b745b09b483"},"state":{"type":"string","enum":["DONE"],"description":"\"FATTO\" quando il webhook ha elaborato correttamente i dati inviati dall'utente.","example":"DONE"},"email":{"type":"string","format":"email","example":"example@openapi.com"},"name":{"type":"string","example":"Mario Openapi"},"redirectUrl":{"type":"string","example":"https://openapi.com"},"verificationUrl":{"type":"string","description":"URL a cui reindirizzare l'utente per effettuare la verifica. Scade tra 15 minuti. Se scaduto, lo stato sarà \"rifiutato\" e la procedura di verifica dell'identità (IDV) verrà chiusa con il dettaglio \"applicant_never_started\"","example":"https://idv.checkout.com/21aef278-e68d-43bf-b12a-d63969d1dee6"},"status":{"type":"string","description":"Ad esempio: approvato, respinto, inconcludente, rifiutato.","enum":["approved","declined","inconclusive","refused"],"example":"approved"},"details":{"type":"string","nullable":true,"description":"Fornisce ulteriori informazioni sullo stato (ad es. approvato, documento_contraffatto, acquisizione_interrotta, richiedente_non_ha_mai_iniziato)","example":"approved"},"riskLabels":{"type":"array","items":{"type":"string"},"example":[]},"documents":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","example":"ID"},"number":{"type":"string","example":"CA12345AA"},"issuingCountry":{"type":"string","example":"IT"},"issueDate":{"type":"string","format":"date","example":"2020-02-12"},"expiryDate":{"type":"string","format":"date","example":"2031-02-06"},"mrz":{"type":"string","example":"C