> ## 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.

# Business Ownership Document Verification Result

> Response schema for business ownership document verification checks

The Business Ownership Document Verification check returns a detailed analysis of the provided ownership documents and verification results. The check result will be returned in the `payload` field of the check result object.

## Response Schema

<ResponseField name="type" type="string" required>
  Type identifier "KYBBusinessOwnershipVerificationResult"
</ResponseField>

<ResponseField name="verified_business_owners" type="array">
  List of business owners that were successfully verified

  <Expandable title="properties">
    <ResponseField name="full_name" type="string">
      Full name of the business owner
    </ResponseField>

    <ResponseField name="percentage" type="number">
      Ownership percentage (0-100)
    </ResponseField>

    <ResponseField name="shares" type="number">
      Number of shares owned
    </ResponseField>

    <ResponseField name="owner_type" type="string">
      Type of owner ("individual" or "entity")
    </ResponseField>

    <ResponseField name="business_name" type="string">
      Business name if owner\_type is "entity"
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="unverified_business_owners" type="array">
  List of business owners that could not be verified

  <Expandable title="properties">
    Same structure as verified\_business\_owners
  </Expandable>
</ResponseField>

<ResponseField name="valid_documents" type="array">
  List of valid ownership documents that were successfully verified

  <Expandable title="properties">
    <ResponseField name="is_valid_document" type="boolean">
      Whether the document is a valid ownership document
    </ResponseField>

    <ResponseField name="analysis" type="string">
      Detailed analysis of why the document is valid or invalid
    </ResponseField>

    <ResponseField name="summary" type="string">
      Summary of the document's contents and purpose
    </ResponseField>

    <ResponseField name="date" type="string">
      Document date in YYYY-MM-DD format
    </ResponseField>

    <ResponseField name="alerts" type="object">
      Any alerts or warnings about the document
    </ResponseField>

    <ResponseField name="documented_business_owners" type="array">
      List of business owners found in this document

      <Expandable title="properties">
        <ResponseField name="full_name" type="string">
          Full name of the business owner
        </ResponseField>

        <ResponseField name="percentage" type="number">
          Ownership percentage (0-100)
        </ResponseField>

        <ResponseField name="shares" type="number">
          Number of shares owned
        </ResponseField>

        <ResponseField name="owner_type" type="string">
          Type of owner ("individual" or "entity")
        </ResponseField>

        <ResponseField name="business_name" type="string">
          Business name if owner\_type is "entity"
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total_shares" type="number">
      Total number of shares in the company
    </ResponseField>

    <ResponseField name="document" type="object">
      The original document metadata

      <Expandable title="properties">
        <ResponseField name="type" type="string">
          Type identifier "Document"
        </ResponseField>

        <ResponseField name="url" type="string">
          URL of the document
        </ResponseField>

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

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

<ResponseField name="invalid_documents" type="array">
  List of invalid ownership documents that failed verification

  <Expandable title="properties">
    Same structure as valid\_documents
  </Expandable>
</ResponseField>

### Example Response

```json theme={null}
{
  "type": "KYBBusinessOwnershipVerificationResult",
  "verified_business_owners": [
    {
      "full_name": "Ajmal Asver",
      "percentage": 49.0,
      "shares": 4500000,
      "owner_type": "individual",
      "business_name": null
    },
    {
      "full_name": "Miguel Rios",
      "percentage": 49.0,
      "shares": 4500000,
      "owner_type": "individual",
      "business_name": null
    }
  ],
  "unverified_business_owners": [],
  "valid_documents": [
    {
      "is_valid_document": true,
      "analysis": "This document is a valid stakeholder ledger dated June 17, 2024. It provides detailed information on various stakeholders, including individuals and entities, their outstanding shares, ownership percentages, and fully diluted ownership. The document appears to be comprehensive and official, listing multiple investors and their respective stakes in the company.",
      "summary": "This document is an All Stakeholder Ledger dated June 17, 2024. It provides a detailed breakdown of ownership for multiple stakeholders in a company. The ledger includes information such as outstanding shares, ownership percentages, fully diluted shares, and cash raised for each stakeholder. It lists both individual and entity owners, providing a comprehensive overview of the company's ownership structure.",
      "date": "2024-06-17",
      "alerts": null,
      "documented_business_owners": [
        {
          "full_name": "Miguel Rios",
          "percentage": 49.0,
          "shares": 4500000,
          "owner_type": "individual",
          "business_name": null
        },
        {
          "full_name": "Ajmal Asver",
          "percentage": 49.0,
          "shares": 4500000,
          "owner_type": "individual",
          "business_name": null
        },
        {
          "full_name": "GTM Flow",
          "percentage": 0.0,
          "shares": 7000,
          "owner_type": "entity",
          "business_name": null
        }
      ],
      "total_shares": 9007000,
      "document": {
        "type": "Document",
        "url": "https://storage.googleapis.com/parcha-ai-public-assets/All%20Stakeholders%20Ledger%20June%2017%202024.pdf",
        "file_name": "Parcha_cap_table.pdf",
        "source_type": "file_url"
      }
    }
  ],
  "invalid_documents": []
}
```