Skip to main content
Didit Raises $7.5M to Build the Infrastructure for Identity and Fraud
Didit
Back to blog
Blog · March 7, 2026

Build Custom Proof of Address with Didit's API & ML

Learn how to integrate Didit's Proof of Address API to build a robust and highly customizable address verification service. This guide covers leveraging machine learning for document parsing, implementing configurable.

By DiditUpdated
build-custom-proof-of-address-with-didits-api-ml.png

Streamlined IntegrationDidit's Proof of Address API provides a developer-first approach, offering clean APIs for seamless integration into custom services, allowing for rapid deployment and reduced development overhead.

Advanced Machine LearningLeverage Didit's AI-native capabilities for intelligent document parsing, authenticity checks, and precise data extraction from various Proof of Address documents, ensuring high accuracy and efficiency.

Configurable Verification RulesCustomize verification workflows with Didit's flexible settings, allowing you to define actions for name mismatches, document quality issues, and unsupported languages, tailoring the service to your specific compliance and risk requirements.

Global Compliance and Fraud PreventionDidit enhances your custom Proof of Address service by integrating robust fraud detection mechanisms and supporting global document types and languages, all while offering Free Core KYC and a modular architecture.

The Growing Need for Robust Proof of Address Verification

In today's digital landscape, verifying a user's physical address is a critical component of Know Your Customer (KYC) and Anti-Money Laundering (AML) compliance, fraud prevention, and overall trust building. Traditional manual processes are slow, error-prone, and unsustainable at scale. Businesses need a sophisticated, automated solution that can handle diverse document types, detect fraud, and seamlessly integrate into existing systems. This is where a developer-centric approach, empowered by advanced APIs and machine learning, becomes indispensable.

Building a custom Proof of Address (PoA) service requires more than just document scanning; it demands intelligent data extraction, authenticity checks, and configurable decision-making. Didit's Proof of Address product offers a powerful foundation for developers looking to create a bespoke, reliable, and scalable PoA verification system, complete with features like OCR, document type detection, and structured data output.

Leveraging Machine Learning for Intelligent Document Parsing

At the heart of an effective PoA service lies robust machine learning capabilities. Didit's AI-native platform excels in this area, utilizing advanced algorithms to parse and extract information from a wide array of document types, including utility bills, bank statements, and government-issued documents. When a document is submitted to Didit's API, it undergoes a comprehensive analysis:

  • Optical Character Recognition (OCR): Extracts text from images or PDFs with high accuracy, regardless of font or document condition.
  • Document Type Detection: Automatically identifies the type of document submitted (e.g., UTILITY_BILL, BANK_STATEMENT).
  • Data Extraction: Intelligently pulls key fields such as name, address, issuer, and issue date. The system provides both raw and structured address data, including street_1, street_2, city, region, and postal_code, along with geographic coordinates.
  • Authenticity Checks: Scrutinizes the document for signs of manipulation, poor quality, or metadata inconsistencies, flagging potential fraud risks like SUSPECTED_DOCUMENT_MANIPULATION or POOR_DOCUMENT_QUALITY.

This ML-driven approach significantly reduces the need for manual review, speeding up the verification process and improving accuracy, which is crucial for compliance and a smooth user experience.

Building Custom Verification Logic with Configurable Settings

One of the most powerful aspects of Didit's Proof of Address API is its modular architecture, which allows developers to define custom verification rules and actions. This flexibility is key for adapting to specific business requirements, risk appetites, and regulatory landscapes. The API provides various parameters to fine-tune the verification process:

  • poa_languages_allowed: Specify a comma-separated list of acceptable document languages.
  • poa_document_age_months: Set custom age limits for different document types (e.g., utility_bill:3,bank_statement:3 for a 3-month validity period). Documents older than the specified limit will trigger an EXPIRED_DOCUMENT warning, leading to an automatic decline if configured.
  • expected_address, expected_country, expected_first_name, expected_last_name: Cross-validate extracted data against pre-provided information, enhancing accuracy and fraud detection.

Moreover, Didit offers configurable actions for various risk categories, allowing you to decide whether a specific warning should DECLINE the verification, send it IN_REVIEW, or APPROVE it with a warning. This includes actions for poa_name_mismatch_action, poa_document_issues_action, poa_document_authenticity_action, poa_unsupported_language_action, and poa_address_mismatch_action. For instance, you can configure the system to automatically decline if a NAME_MISMATCH_WITH_PROVIDED occurs, or send it for manual review if the name_match_score falls below a certain threshold. This granular control empowers businesses to build a PoA service that aligns perfectly with their operational policies and risk management framework.

Integrating the Proof of Address API: A Developer's Perspective

Didit is designed with developers in mind, offering a developer-first experience with instant sandboxes, public documentation, and clean APIs. Integrating the Proof of Address API is straightforward. You can submit document images or PDFs via a simple POST request to the /v3/poa/ endpoint, passing parameters like the document file, expected user details, and your desired configurable actions.

The API returns a comprehensive JSON response, including the overall poa.status (e.g., Approved, Declined), extracted document details (document_type, issuer, issue_date), parsed address information, and a list of any warnings encountered during the process. This structured output makes it easy to consume the verification results and integrate them into your backend systems or user interfaces. For example, if a POA_DOCUMENT_NOT_SUPPORTED_FOR_APPLICATION warning is triggered, your system can immediately inform the user to submit an acceptable document type. Didit's API ensures that you have all the necessary data to make informed decisions and maintain a high level of compliance.

How Didit Helps

Didit stands out as the premier choice for building a custom Proof of Address service due to its AI-native, developer-first approach and comprehensive feature set. Our Free Core KYC offering allows businesses to get started without upfront costs, making advanced identity verification accessible to all. Didit's modular architecture means you can seamlessly integrate Proof of Address functionality alongside other critical identity services such as ID Verification (OCR, MRZ, barcodes), Passive & Active Liveness, 1:1 Face Match, and AML Screening & Monitoring. Our platform provides structured identity data, automates workflows, and is globally designed to handle diverse document types and languages. The ability to customize verification settings and actions for various risk factors ensures that your PoA service is not only efficient but also precisely tailored to your unique business needs and regulatory requirements. With Didit, you bypass complex infrastructure development and focus on building exceptional user experiences, knowing your identity verification is powered by a leading, AI-native platform.

Ready to Get Started?

Ready to see Didit in action? Get a free demo today.

Start verifying identities for free with Didit's free tier.

Infrastructure for identity and fraud.

One API for KYC, KYB, Transaction Monitoring, and Wallet Screening. Integrate in 5 minutes.

Ask an AI to summarise this page
Build Custom Proof of Address with Didit's API & ML.