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

# Mortgage (VOM)

> Technical specification for the Verification of Mortgage document

> See the [VOR/VOM Overview](/entity-models/tasks/verification-of-rent-mortgage) for common fields, integration notes, workflow, and general information about VOR/VOM forms.

## Required data fields

### Request information (completed by lender/borrower)

| Field Name         | Type   | Required    | Data Source               | Notes                         |
| ------------------ | ------ | ----------- | ------------------------- | ----------------------------- |
| Account type       | String | Yes         | User input                | Enum: "MORTGAGE"              |
| Property address   | String | Yes         | Loan entity or User input | Address of mortgaged property |
| Account in name of | String | Yes         | Borrower entity           | Name(s) on the account        |
| Account number     | String | Conditional | User input                | Account number if available   |

### Verification information (completed by creditor)

| Field Name                       | Type    | Required    | Data Source       | Notes                                                          |
| -------------------------------- | ------- | ----------- | ----------------- | -------------------------------------------------------------- |
| Account type verified            | String  | Yes         | Third-party input | Enum: "MORTGAGE\_ACCOUNT"                                      |
| Date mortgage originated         | Date    | Yes         | Third-party input | Date mortgage was originated, format: MM/DD/YYYY               |
| Interest rate                    | Number  | Yes         | Third-party input | Interest rate as percentage                                    |
| Original mortgage amount         | Number  | Yes         | Third-party input | Original loan amount in dollars                                |
| Current mortgage balance         | Number  | Yes         | Third-party input | Current outstanding balance in dollars                         |
| Monthly payment P\&I             | Number  | Yes         | Third-party input | Monthly principal and interest payment in dollars              |
| Payment with taxes and insurance | Number  | Yes         | Third-party input | Total monthly payment including taxes and insurance in dollars |
| Next payment date                | Date    | Yes         | Third-party input | Next scheduled payment date, format: MM/DD/YYYY                |
| Number of late payments          | Number  | Yes         | Third-party input | Number of late payments in last 12 months                      |
| Mortgage current                 | Boolean | Yes         | Third-party input | Whether mortgage is current                                    |
| Mortgage assumable               | Boolean | Yes         | Third-party input | Whether mortgage is assumable                                  |
| Insurance agent                  | String  | Conditional | Third-party input | Name of insurance agent if applicable                          |
| Mortgage type                    | String  | Yes         | Third-party input | Enum: "FIXED", "ARM"                                           |
| Loan program                     | String  | Yes         | Third-party input | Enum: "FHA", "VA", "FNMA", "CONV"                              |

## Suggested questions for data collection

### Request questions (lender/borrower)

| Question                                   | Response Type | Validation                                    |
| ------------------------------------------ | ------------- | --------------------------------------------- |
| "What type of account needs verification?" | Select        | Required, option: Mortgage                    |
| "What is the mortgaged property address?"  | Text input    | Auto-populated from loan entity or user input |
| "What name(s) are on the account?"         | Text input    | Auto-populated from borrower entity           |
| "What is the account number?"              | Text input    | Optional if available                         |

### Verification questions (creditor)

| Question                                                           | Response Type | Validation                                    |
| ------------------------------------------------------------------ | ------------- | --------------------------------------------- |
| "What type of account is this?"                                    | Select        | Required, option: Mortgage Account            |
| "When was the mortgage originated?"                                | Date          | Required, format: MM/DD/YYYY                  |
| "What is the interest rate?"                                       | Number        | Required, positive number, format: percentage |
| "What was the original mortgage amount?"                           | Number        | Required, positive number, format: currency   |
| "What is the current mortgage balance?"                            | Number        | Required, positive number, format: currency   |
| "What is the monthly principal and interest payment?"              | Number        | Required, positive number, format: currency   |
| "What is the total monthly payment including taxes and insurance?" | Number        | Required, positive number, format: currency   |
| "What is the next payment date?"                                   | Date          | Required, format: MM/DD/YYYY                  |
| "How many late payments have occurred in the last 12 months?"      | Number        | Required, non-negative integer                |
| "Is the mortgage current?"                                         | Yes/No        | Required                                      |
| "Is the mortgage assumable?"                                       | Yes/No        | Required                                      |
| "What is the name of the insurance agent? (if applicable)"         | Text input    | Optional                                      |
| "What is the mortgage type?"                                       | Select        | Required, options: Fixed, ARM                 |
| "What is the loan program?"                                        | Select        | Required, options: FHA, VA, FNMA, CONV        |
