> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parcha.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Individual (KYC) Proof of Address Document Verification

> Verify individual proof of address documents and validate address information

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

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

## Example Response

```json theme={null}
{
  "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

<ResponseField name="type" type="string">
  The type identifier for the response. Will be "KYCProofOfAddressCheckResult".
</ResponseField>

<ResponseField name="valid_documents" type="array">
  Array of documents that passed all verification checks.
</ResponseField>

<ResponseField name="invalid_documents" type="array">
  Array of documents that failed one or more verification checks.
</ResponseField>

<ResponseField name="verified_name" type="string">
  The verified name of the individual that matches the self-attested name.
</ResponseField>

<ResponseField name="verified_address" type="object">
  The confirmed address after verification checks.
</ResponseField>

<ResponseField name="document_type" type="string">
  The type of document used for address verification (e.g., "utility\_bill", "bank\_statement").
</ResponseField>

<ResponseField name="valid_document" type="boolean">
  Whether the document is valid and meets all verification requirements.
</ResponseField>

## Key Components

### Document Analysis

Each document in `valid_documents` or `invalid_documents` contains the following components:

#### Extraction Data

<ResponseField name="is_valid_document" type="boolean">
  Indicates whether the document structure and content are valid.
</ResponseField>

<ResponseField name="analysis" type="string">
  Detailed analysis of the document content and its validity.
</ResponseField>

<ResponseField name="summary" type="string">
  Brief overview of the document's key information.
</ResponseField>

<ResponseField name="date" type="string">
  The document's date in ISO format.
</ResponseField>

<ResponseField name="alerts" type="object">
  Any alerts or warnings associated with the document validation.
</ResponseField>

<ResponseField name="name" type="string">
  Individual's name extracted from the document.
</ResponseField>

<ResponseField name="address" type="object">
  Address found in the document.
</ResponseField>

#### Document Metadata

<ResponseField name="document" type="object">
  Metadata about the document being verified.

  <ResponseField name="type" type="string">
    The type identifier for the document object. Will be "Document".
  </ResponseField>

  <ResponseField name="url" type="string">
    The URL where the document can be accessed.
  </ResponseField>

  <ResponseField name="file_name" type="string">
    The name of the document file.
  </ResponseField>

  <ResponseField name="description" type="string | null">
    Optional description of the document.
  </ResponseField>

  <ResponseField name="source_type" type="string">
    The type of source for the document (e.g., "file\_url").
  </ResponseField>

  <ResponseField name="num_pages" type="number | null">
    The number of pages in the document, if available.
  </ResponseField>
</ResponseField>

### Address Object Structure

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