> ## 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 de comprovativo de morada: verificação de faturas > Verifique moradas com a Didit através de IA em faturas, extratos bancários e documentos oficiais. Pague por chamada $0.20. A verificação de comprovativo de morada (PoA) permite-lhe verificar a morada residencial de um utilizador através de documentos oficiais. Esta funcionalidade simplifica o processo de verificação de morada, permitindo ao utilizador capturar ou carregar documentos que confirmem a sua morada. Prompt de integração de comprovativo de morada Copiar o prompt para a área de transferência \

\````# 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````

\
Colar em A lição da Academy sobre como ler um resultado de verificação chega à verificação de comprovativo de morada aos 7:20.[Comprovativo de morada — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=440\&rel=0\&playsinline=1)## Como funcionaA verificação do comprovativo de morada da Didit oferece uma solução robusta para verificar a morada de residência de um utilizador através de documentação oficial. A nossa solução combina IA avançada, visão computacional e verificações de segurança abrangentes para fornecer uma verificação de morada rápida e fiável em grande escala.**1. Captura inteligente de documentos**Os utilizadores podem verificar a sua morada através de:| Método | Descrição | | - | - | | **Captura automática** | A nossa IA deteta automaticamente o posicionamento ideal do documento e efetua a captura automática no momento perfeito | | **Opção de carregamento** | Os utilizadores podem carregar documentos existentes em vários formatos (PDF, JPG, PNG) | | **Suporte para várias páginas** | Processa perfeitamente documentos com várias páginas, como extratos bancários |**2. Extração e verificação avançada de dados**Capacidades de processamento avançadas:- OCR de alta precisão para extração de informação de moradas - Classificação inteligente de documentos para identificar tipos de documentos - Correspondência de nomes com documentos de identidade para verificação cruzada - Extração e validação da data de emissão face aos requisitos configurados - Correspondência de formatos e padrões para todos os campos de morada**3. Validação abrangente**O nosso sistema baseado em IA realiza verificações rigorosas:| Verificação | Descrição | | - | - | | **Autenticidade do documento** | Verificação da legitimidade do documento | | **Deteção de adulteração** | Análise da integridade da imagem para detetar manipulação | | **Normalização de moradas** | Formatação e normalização dos campos de morada | | **Geocodificação** | Fornecimento de coordenadas de localização a partir da morada extraída | | **Deteção de idioma** | Identificação e validação do idioma do documento |**4. Entrega fluida dos resultados**Aceda aos resultados da verificação através de múltiplos canais:- Atualizações no painel em tempo real - Notificações instantâneas por webhook - Integração com a API RESTful - Relatórios abrangentes com informações detalhadas da sessão de verificação## Requisitos dos documentosPara garantir uma verificação de morada bem-sucedida, os documentos devem cumprir estes critérios:#### Tipos de documentos aceitesA tabela seguinte lista os tipos de documentos aceites e os respetivos subtipos. Todos os documentos devem ser emitidos nos últimos 3 meses, salvo indicação em contrário.| Tipo de documento | Subtipos | | - | - | | **Fatura de serviços públicos** | Fatura de eletricidade, fatura da água, fatura do gás, fatura de internet, fatura telefónica, fatura de televisão por cabo, fatura de televisão por satélite, fatura de recolha de lixo, fatura de saneamento, fatura de aquecimento, fatura combinada de serviços públicos, fatura de serviços municipais | | **Extrato bancário** | Extrato de conta, extrato de cartão de crédito, declaração bancária de confirmação de morada, extrato de crédito à habitação, extrato de empréstimo, extrato de conta poupança, extrato de conta à ordem, extrato de conta de investimentos, extrato de conta empresarial, extrato de cooperativa de crédito, extrato de cartão de débito, extrato de linha de crédito | | **Documento emitido pelo governo** | Liquidação de impostos, cartão de eleitor, documento de identificação, certificado de residência, carta/notificação oficial, carta do recenseamento, certificado de registo individual, imposto municipal sobre imóveis, registo automóvel, extrato da segurança social, declaração de subsídio de desemprego, declaração de prestações de invalidez, extrato de pensão, citação judicial, notificação para serviço de júri, licença municipal, documento de imigração | | **Outro comprovativo de morada** | Contrato de arrendamento, contrato de aluguer, declaração da entidade patronal de confirmação de morada, apólice de seguro, declaração de matrícula escolar, declaração de morada com termo de autenticação, declaração de solicitador de confirmação de morada, extrato de empréstimo de estudante, documento judicial de confirmação de morada, seguro multirriscos habitação, seguro de recheio, seguro automóvel, extrato de seguro de saúde, conta médica, conta hospitalar, fatura de serviço de subscrição, extrato de mensalidade de ginásio, carta da empresa de administração de imóveis, declaração de associação de proprietários, certificado de notas universitário, comprovativo de matrícula no ensino superior, recibo de vencimento, declaração de vínculo laboral, extrato de conta de reforma, extrato de conta de corretagem |#### Disponibilidade por paísPor predefinição, o Comprovativo de morada suporta os mesmos países e territórios que a Verificação de identidade, incluindo as Ilhas Turcas e Caicos (`TCA`) e Tuvalu (`TUV`). Todos os países e territórios suportados oferecem as quatro categorias de documentos listadas acima. Pode restringir esta cobertura predefinida nas definições de Comprovativo de morada do seu fluxo.> [!NOTE] > > Se um fluxo existente não apresentar um país recentemente suportado, abra as respetivas definições de Comprovativo de morada e guarde-as novamente para atualizar a configuração de países permitidos do fluxo.![Tipos de documentos aceites pelo Didit para comprovativo de morada — faturas de serviços públicos, extratos bancários e documentos governamentais](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)#### Requisitos gerais- Documento válido emitido nos últimos 90 dias - Em bom estado físico (sem danos, riscos ou manchas) - Informação completa da morada claramente visível - Nome e logótipo do emissor do documento visíveis - O nome no documento deve corresponder à identidade verificada do utilizador - Diferente do documento de identificação (não pode ser o mesmo documento utilizado para a verificação de identidade)#### Requisitos da imagem- Documento original capturado em tempo real ou digitalização de alta qualidade - Formatos suportados: JPG, JPEG, PNG, TIFF, PDF - Tamanho máximo do ficheiro: 15MB - Imagem a cores com todos os cantos visíveis - Sem edição ou manipulação digital - Todas as páginas incluídas em documentos de várias páginas This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.