The individual proof of address document verification check response payload contains a detailed analysis of submitted address documents. The response includes extracted information, fraud detection findings, visual inspection, and overall validation results.

​
Check ID

kyc.proof_of_address_verification

​
Response Structure

{
  type: "KYCProofOfAddressCheckResult";
  valid_documents: Array<Document>;
  invalid_documents: Array<Document>;
  verified_name: string;
  verified_address: Address;
  document_type: string;
  valid_document: boolean;
}

​
Example Response

{
  "type": "KYCProofOfAddressCheckResult",
  "valid_documents": [
    {
      "extraction_data": {
        "is_valid_document": true,
        "analysis": "This is a valid utility bill showing the individual's address. The document contains all required elements including full name, current address, and recent date. The document appears to be authentic and unmodified.",
        "summary": "This is a utility bill for John Doe dated June 1, 2024, showing the residential address in San Francisco.",
        "date": "2024-06-01",
        "alerts": null,
        "name": "John Doe",
        "address": {
          "type": "Address",
          "street_1": "746 4th Avenue",
          "street_2": null,
          "city": "San Francisco",
          "state": "CA",
          "country_code": "US",
          "postal_code": "94118"
        }
      },
      "fraud_verification_data": null,
      "visual_inspection": null,
      "document": {
        "type": "Document",
        "url": "https://storage.googleapis.com/parcha-ai-public-assets/John_proof_of_address.pdf",
        "file_name": "John_proof_of_address.pdf",
        "description": null,
        "source_type": "file_url",
        "num_pages": null
      }
    }
  ],
  "invalid_documents": [],
  "verified_name": "John Doe",
  "verified_address": {
    "type": "Address",
    "street_1": "746 4th Avenue",
    "street_2": null,
    "city": "San Francisco",
    "state": "CA",
    "country_code": "US",
    "postal_code": "94118"
  },
  "document_type": "utility_bill",
  "valid_document": true
}

​
Response Fields

​
type
string
The type identifier for the response. Will be “KYCProofOfAddressCheckResult”.
​
valid_documents
array
Array of documents that passed all verification checks.
​
invalid_documents
array
Array of documents that failed one or more verification checks.
​
verified_name
string
The verified name of the individual that matches the self-attested name.
​
verified_address
object
The confirmed address after verification checks.
​
document_type
string
The type of document used for address verification (e.g., “utility_bill”, “bank_statement”).
​
valid_document
boolean
Whether the document is valid and meets all verification requirements.

​
Key Components

​
Document Analysis

Each document in valid_documents or invalid_documents contains the following components:

​
Extraction Data

​
is_valid_document
boolean
Indicates whether the document structure and content are valid.
​
analysis
string
Detailed analysis of the document content and its validity.
​
summary
string
Brief overview of the document’s key information.
​
date
string
The document’s date in ISO format.
​
alerts
object
Any alerts or warnings associated with the document validation.
​
name
string
Individual’s name extracted from the document.
​
address
object
Address found in the document.

​
Document Metadata

​
document
object
Metadata about the document being verified.
​
type
string
The type identifier for the document object. Will be “Document”.
​
url
string
The URL where the document can be accessed.
​
file_name
string
The name of the document file.
​
description
string | null
Optional description of the document.
​
source_type
string
The type of source for the document (e.g., “file_url”).
​
num_pages
number | null
The number of pages in the document, if available.

​
Address Object Structure

{
  type: "Address";
  street_1: string;
  street_2: string | null;
  city: string;
  state: string;
  country_code: string;
  postal_code: string;
}