Integrate Didit Proof of Address standalone API to verify address documents. Use when the user wants to verify a proof of address, validate utility bills, bank statements, government documents, extract address from documents, verify residential address, implement address verification, or perform PoA checks using Didit. Supports OCR extraction, geocoding, name matching, and multi-page documents.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
Instruções da origem · Visualização somente leitura
name
didit-proof-of-address
description
Integrate Didit Proof of Address standalone API to verify address documents. Use when the user wants to verify a proof of address, validate utility bills, bank statements, government documents, extract address from documents, verify residential address, implement address verification, or perform PoA checks using Didit. Supports OCR extraction, geocoding, name matching, and multi-page documents.
Verifies address documents by submitting images or PDFs. Extracts address information, performs authenticity checks, name matching, geocoding, and returns structured data.
Key constraints:
Supported formats: JPG, JPEG, PNG, TIFF, PDF
Maximum file size: 15MB
Document must be within 90 days of issue date
Full-color, all corners visible, no digital editing
Must be different from the ID document used for ID verification
Capabilities: OCR extraction, intelligent document classification, name matching with identity documents, issue date validation, geocoding with lat/lng coordinates, language detection, multi-page support.
{"request_id":"a1b2c3d4-...","poa":{"status":"Approved","issuing_state":"ESP","document_type":"UTILITY_BILL","issuer":"Endesa","issue_date":"2025-01-15","document_language":"es","name_on_document":"Elena Martínez Sánchez","poa_address":"Calle Mayor 10, 28013 Madrid","poa_formatted_address":"Calle Mayor 10, 28013 Madrid, Spain","poa_parsed_address":{"street_1":"Calle Mayor 10","city":"Madrid","region":"Comunidad de Madrid","postal_code":"28013","raw_results":{"geometry":{"location":{"lat":40.4168,"lng":-3.7038}}}},"document_file":"https://example.com/document.pdf","warnings":[]},"created_at":"2025-05-01T13:11:07.977806Z"}
Status Values & Handling
Status
Meaning
Action
"Approved"
Address verified, document valid
Proceed with your flow
"Declined"
Document invalid or expired
Check warnings for specific reason
"In Review"
Needs manual review
Check for name mismatch or quality issues
"Not Finished"
Processing incomplete
Wait or retry
Error Responses
Code
Meaning
Action
400
Invalid request
Check file format, size, parameters
401
Invalid API key
Verify x-api-key header
403
Insufficient credits
Top up at business.didit.me
Response Field Reference
Field
Type
Description
status
string
"Approved", "Declined", "In Review", "Not Finished"
Warning severity: error (→ Declined), warning (→ In Review), information (no effect).
Common Workflows
Basic Address Verification
1. POST /v3/poa/ → {"document": utility_bill}
2. If "Approved" → address verified
If "Declined" → check warnings:
EXPIRED_DOCUMENT → ask for a more recent document
MISSING_ADDRESS_INFORMATION → ask for clearer image
NAME_MISMATCH → verify identity matches
Full KYC with Address
1. POST /v3/id-verification/ → verify identity document
2. POST /v3/passive-liveness/ → verify real person
3. POST /v3/poa/ → verify address
4. System auto-matches name between ID and PoA documents
5. All Approved → identity + address verified
Utility Scripts
verify_address.py: Verify proof of address documents from the command line.
