Individual (KYC) Proof of Address Document Verification

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

string

The type identifier for the response. Will be “KYCProofOfAddressCheckResult”.

array

Array of documents that passed all verification checks.

array

Array of documents that failed one or more verification checks.

string

The verified name of the individual that matches the self-attested name.

object

The confirmed address after verification checks.

string

The type of document used for address verification (e.g., “utility_bill”, “bank_statement”).

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

boolean

Indicates whether the document structure and content are valid.

string

Detailed analysis of the document content and its validity.

string

Brief overview of the document’s key information.

string

The document’s date in ISO format.

object

Any alerts or warnings associated with the document validation.

string

Individual’s name extracted from the document.

object

Address found in the document.

Document Metadata

object

Metadata about the document being verified.

string

The type identifier for the document object. Will be “Document”.

string

The URL where the document can be accessed.

string

The name of the document file.

string | null

Optional description of the document.

string

The type of source for the document (e.g., “file_url”).

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;
}

Getting Started

Checks Results

API Reference

Individual (KYC) Proof of Address Document Verification

Check ID

Response Structure

Example Response

Response Fields

Key Components

Document Analysis

Extraction Data

Document Metadata

Address Object Structure

​Check ID

​Response Structure

​Example Response

​Response Fields

​Key Components

​Document Analysis

​Extraction Data

​Document Metadata

​Address Object Structure

Check ID

Response Structure

Example Response

Response Fields

Key Components

Document Analysis

Extraction Data

Document Metadata

Address Object Structure