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.

​
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;
}
Source of Funds Document VerificationPEP Screening Check