> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API di prova di residenza: verifica delle bollette

> Verifica gli indirizzi di residenza con Didit tramite l'estrazione AI da bollette, estratti conto e documenti ufficiali. $0.20 a chiamata.

La verifica della prova di residenza (PoA) ti consente di verificare l'indirizzo di residenza di un utente tramite documenti ufficiali. Questa funzionalità semplifica il processo di verifica dell'indirizzo, permettendo agli utenti di acquisire o caricare i documenti che confermano il proprio indirizzo.

Prompt di integrazione della prova di residenza
        Copia il prompt negli appunti



      
      

\<pre>

\````# Goal
Integrate Didit Proof of Address (utility bill, bank statement, government letter OCR + cross-checks) into your app. Pick ONE mode.

\# Mode A — Session-based
Use this when the user uploads the document in a hosted Didit flow.

1\. Add the PROOF_OF_ADDRESS feature to the workflow (Business Console or POST /v3/workflows/). Configure: poa_languages_allowed, poa_document_age_months, and the per-risk actions (poa_issuer_not_identified_action, poa_name_mismatch_action, poa_address_mismatch_action, poa_document_expired_action, poa_language_not_allowed_action).
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user (or mount the Web/Mobile SDK).
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

Decision surface: `poa_verifications[]` array on the decision payload.

\# Mode B — Standalone API (server-to-server)
Use when you already have the document and want a one-shot check decoupled from a hosted flow.

POST https://verification.didit.me/v3/poa/
multipart/form-data — x-api-key: YOUR_API_KEY

Latency: OCR typically takes 5–15s (up to ~30s for multi-page PDFs). Use a client timeout of **at least 45s**. Max upload 15 MB (PDF, JPG, PNG, TIFF, WebP). Encrypted PDFs require `document_password` or you get HTTP 400 with `code: "encrypted_pdf"`.

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/poa/' \
-H "x-api-key: $DIDIT_API_KEY" \
-F "document=@./utility-bill.pdf" \
-F "expected_address=Av. Monseñor Tavella 3396, Salta" \
-F "expected_country=ARG" \
-F "expected_first_name=Sophia" \
-F "expected_last_name=Martinez" \
-F "poa_languages_allowed=en,es" \
-F "vendor_data=user-1234"
\```
Returns: { request_id, poa: { status, parsed_address, document_type, issuer, issue_date, language, document_metadata: { overlay_manipulation }, warnings: [...] } }.

\# Status enum (per poa_verifications[].status / poa.status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.PROOF_OF_ADDRESS)
warnings[] risk codes include:
ISSUER_NOT_IDENTIFIED, LANGUAGE_NOT_ALLOWED, DOCUMENT_EXPIRED, DOCUMENT_TOO_OLD, NAME_MISMATCH, ADDRESS_MISMATCH, COUNTRY_MISMATCH, OVERLAY_MANIPULATION_DETECTED, UNREADABLE_DOCUMENT.
Full catalogue: /core-technology/proof-of-address/warnings-proof-of-address.

\# Failure modes to handle
\- HTTP 400 with `code: "encrypted_pdf"` — the PDF is password-protected (or the password is wrong); supply the right `document_password` or a decrypted copy.
\- HTTP 400 with `code: "document_unreadable"` — the file is corrupt or cannot be opened; ask the user for a different file. Branch on `code`, not on the message text.
\- HTTP 503 with `code: "document_processing_busy"`: too many documents are being processed, so the upload was not processed. Send the same file again after the `Retry-After` seconds.
\- HTTP 403 — out of credits.
\- Client timeout — bump to 45s+ before retrying.
\- status="Declined" with NAME_MISMATCH / ADDRESS_MISMATCH — the extracted fields don't match expected_*; do not approve.
\- OVERLAY_MANIPULATION_DETECTED — PDF forensics caught edits; reject.

\# See also
\- Canonical schema: /reference/data-models#proof-of-address
\- Per-feature report: /core-technology/proof-of-address/report-proof-of-address
\- Risk catalogue: /core-technology/proof-of-address/warnings-proof-of-address
\- Full integration playbook: /integration/integration-prompt````

\</pre>



      
      

Incolla in

La lezione dell'Academy sulla lettura di un risultato di verifica arriva al controllo della prova di residenza al minuto 7:20.[Prova di residenza - Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## Come funzionaLa verifica della prova di residenza di Didit offre una soluzione affidabile per verificare l'indirizzo di residenza di un utente tramite documentazione ufficiale. La nostra soluzione combina AI avanzata, visione artificiale e controlli di sicurezza completi per fornire una verifica dell'indirizzo rapida e affidabile su larga scala.**1. Acquisizione intelligente dei documenti**Gli utenti possono verificare il proprio indirizzo tramite:| Metodo | Descrizione |
| - | - |
| **Acquisizione automatica** | La nostra AI rileva automaticamente il posizionamento ottimale del documento e lo acquisisce in modo automatico nel momento ideale |
| **Opzione di caricamento** | Gli utenti possono caricare documenti esistenti in vari formati (PDF, JPG, PNG) |
| **Supporto multi-pagina** | Gestisce facilmente documenti multi-pagina come gli estratti conto bancari |**2. Estrazione dati avanzata e verifica**Potenti capacità di elaborazione:- OCR ad alta precisione per estrarre le informazioni sull'indirizzo
- Classificazione intelligente dei documenti per identificare le tipologie di documento
- Confronto del nome con i documenti di identità per una verifica incrociata
- Estrazione della data di emissione e validazione rispetto ai requisiti configurati
- Verifica del formato e dei pattern per tutti i campi dell'indirizzo**3. Validazione completa**Il nostro sistema basato su AI esegue controlli approfonditi:| Controllo | Descrizione |
| - | - |
| **Autenticità del documento** | Verifica della legittimità del documento |
| **Rilevamento manomissioni** | Analisi dell'integrità dell'immagine per rilevare eventuali manipolazioni |
| **Standardizzazione dell'indirizzo** | Formattazione e normalizzazione dei campi dell'indirizzo |
| **Geocodifica** | Fornitura delle coordinate di posizione a partire dall'indirizzo estratto |
| **Rilevamento della lingua** | Identificazione e validazione della lingua del documento |**4. Consegna dei risultati senza interruzioni**Accedi ai risultati di verifica tramite molteplici canali:- Aggiornamenti in tempo reale nella dashboard
- Notifiche webhook istantanee
- Integrazione API RESTful
- Report completi con informazioni dettagliate sulla sessione di verifica## Requisiti dei documentiPer garantire che la verifica dell'indirizzo vada a buon fine, i documenti devono soddisfare questi criteri:#### Tipi di documenti accettatiLa seguente tabella elenca i tipi di documento accettati e i rispettivi sottotipi. Tutti i documenti devono essere stati emessi negli ultimi 3 mesi, salvo diversa indicazione.| Tipo di documento | Sottotipi |
| - | - |
| **Bolletta** | Bolletta dell'energia elettrica, Bolletta dell'acqua, Bolletta del gas, Bolletta internet, Bolletta telefonica, Bolletta TV via cavo, Bolletta TV satellitare, Bolletta della raccolta dei rifiuti, Bolletta della fognatura, Bolletta del riscaldamento, Bolletta delle utenze combinate, Bolletta dei servizi municipali |
| **Estratto conto bancario** | Estratto conto, Estratto conto carta di credito, Lettera bancaria di conferma dell'indirizzo, Estratto conto mutuo, Estratto conto prestito, Estratto conto di risparmio, Estratto conto corrente, Estratto conto degli investimenti, Estratto conto aziendale, Estratto conto della cooperativa di credito, Estratto conto della carta di debito, Estratto conto della linea di credito |
| **Documento rilasciato dal governo** | Accertamento fiscale, Tessera di iscrizione alle liste elettorali, Documento d'identità, Certificato di residenza, Lettera/notifica governativa, Lettera di censimento, Certificato di iscrizione anagrafica individuale, Avviso imposta sugli immobili, Documento di immatricolazione del veicolo, Estratto conto previdenziale, Lettera relativa ai sussidi di disoccupazione, Lettera relativa all'indennità di invalidità, Estratto conto della pensione, Citazione in giudizio, Notifica di convocazione per la giuria, Permesso municipale, Documento di immigrazione |
| **Altra prova di residenza** | Contratto di locazione, Contratto di affitto, Lettera del datore di lavoro che conferma l'indirizzo, Polizza assicurativa, Lettera di iscrizione scolastica, Dichiarazione giurata notarile di residenza, Lettera dell'avvocato di conferma dell'indirizzo, Estratto conto del prestito studentesco, Documento giudiziario di conferma indirizzo, Polizza assicurativa per proprietari di casa, Polizza assicurativa per inquilini, Polizza assicurativa auto, Dichiarazione dell'assicurazione sanitaria, Fattura medica, Fattura ospedaliera, Fattura del servizio in abbonamento, Estratto conto dell'abbonamento alla palestra, Lettera della gestione immobiliare, Estratto conto dell'associazione dei proprietari di casa, Certificato degli esami universitari, Verifica dell'iscrizione universitaria, Busta paga, Lettera di verifica dell'impiego, Estratto conto del conto pensionistico, Estratto conto del conto di intermediazione |#### Disponibilità per paesePer impostazione predefinita, Prova di residenza supporta gli stessi paesi e territori di Verifica dell'identità, incluse le Isole Turks e Caicos (`TCA`) e Tuvalu (`TUV`). Ogni paese supportato offre le quattro categorie di documenti elencate sopra. Puoi limitare questa copertura predefinita nelle impostazioni di Prova di residenza del tuo workflow.> [!NOTE]
>
> Se un workflow esistente non mostra un paese supportato di recente, apri le relative impostazioni di Prova di residenza e salvale nuovamente per aggiornare la configurazione dei paesi consentiti del workflow.![Tipi di documenti accettati per la Prova di residenza di Didit — bollette, estratti conto bancari e documenti governativi](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/proof-of-address-id-table.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=b065b2bb6f64408442b49d89ab16cb46)#### Requisiti generali- Documento valido emesso entro 90 giorni dalla data di rilascio
- Integro fisicamente (privo di danni, graffi o macchie)
- Informazioni complete sull'indirizzo chiaramente visibili
- Nome e logo dell'ente emittente visibili
- Il nome sul documento deve corrispondere all'identità verificata dell'utente
- Diverso dal documento d'identità (non può essere lo stesso documento utilizzato per la verifica dell'identità)#### Requisiti dell'immagine- Documento originale acquisito in tempo reale o scansione di alta qualità
- Formati supportati: JPG, JPEG, PNG, TIFF, PDF
- Dimensione massima del file: 15MB
- Immagine a colori con tutti gli angoli visibili
- Nessuna modifica o manipolazione digitale
- Tutte le pagine incluse per i documenti multipagina


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.