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

# Doc VOI

> Order a mortgage income report from uploaded documents.

Doc VOI uses paystubs and year-end income documents to support mortgage income calculations when a direct payroll connection is not used.

<Note>
  Doc VOI is designed for mortgage workflows. For standalone document collection, OCR, and authenticity, use [Document Uploads](/workflows/document-processing).
</Note>

## Order a Doc VOI verification

Send the following body to [`POST /v2/verifications`](/api-reference/verifications/order-a-verification). Set `report.type` to `doc-voi-mortgage` and include the employment details represented by the documents.

```json theme={}
{
  "user": "018051aa-f7a9-a0db-2f38-6cfa325e9d69",
  "employments": [
    {
      "employer": "Warehouse Services Inc",
      "status": "active",
      "hire_date": "2023-02-01",
      "termination_date": null
    }
  ],
  "report": {
    "type": "doc-voi-mortgage"
  }
}
```

## Required documents

For each employment, provide:

* The most recent paystub.
* A W-2 or December/year-end paystub for each required prior year.

The employment names and dates in the verification order should match the uploaded documents. The required history can vary by employment and mortgage workflow. If the verification enters `more_data_required`, upload the additional requested documents for the same user.

## Upload documents

After ordering the verification, upload each document for the same user through [`POST /v2/user-uploads`](/api-reference/user-uploads/upload-a-document). A Doc VOI verification does not require a payroll or banking session.

<Frame>
  <img src="https://mintcdn.com/argyle/EtHVUNI_SMseJQur/images/argyle-guides/api-ref/document-verifications/1-documents.png?fit=max&auto=format&n=EtHVUNI_SMseJQur&q=85&s=47c994109741c21d13bfa75c60a90cb5" alt="Doc VOI report PDF." width="1080" height="1397" data-path="images/argyle-guides/api-ref/document-verifications/1-documents.png" />
</Frame>

## Result

Wait for the [`verifications.updated`](/api-reference/verifications-webhooks/updated) webhook while documents are processed and the report is generated. Retrieve the completed report from `report.file_url` or `report.json_url`.

* See [Verification Statuses](/verifications/verification-statuses).
* Follow [Doc VOI re-verification](/verifications/re-verification#doc-voi-with-new-documents) when updated documents are required.
* Use the [Doc VOI test files](/verifications/testing#doc-voi-test-documents).