# M1_FORM_1098_MORTGAGE_INTEREST

---
title: M1_FORM_1098_MORTGAGE_INTEREST 
description: The M1_FORM_1098_MORTGAGE_INTEREST schema represents the details of a 1098 tax form, which reports mortgage interest paid by a taxpayer. It includes information about the borrower, lender, and the amount of interest paid on the mortgage.
---

The M1_FORM_1098_MORTGAGE_INTEREST schema represents the details of a 1098 tax form, which reports mortgage interest paid by a taxpayer. It includes information about the borrower, lender, and the amount of interest paid on the mortgage.

{% json-schema
        schema={
    "title": "M1_1098_RECORD Schema",
    "type": "object",
    "description": "Representation of the 1098 MORTGAGE_INTEREST\n",
    "properties": {
        "record_year": {
            "type": "number",
            "description": "Year on which the record was generated",
            "format": "YYYY",
            "examples": [
                2024
            ]
        },
        "record_date": {
            "type": "string",
            "description": "Date on which the record was generated",
            "format": "MM/DD/YYYY"
        },
        "void": {
            "type": "boolean",
            "description": "Marks the form as void"
        },
        "corrected": {
            "type": "boolean",
            "description": "Marks the form as corrected"
        },
        "recipient": {
            "type": "object",
            "description": "Details of the recipient",
            "properties": {
                "tin": {
                    "type": "string",
                    "description": "Tax identification number of the payer"
                },
                "address": {
                    "type": "object",
                    "properties": {
                        "zipcode": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        },
                        "country": {
                            "type": "object",
                            "properties": {
                                "a2_code": {
                                    "type": "null"
                                },
                                "name": {
                                    "type": "null"
                                }
                            }
                        },
                        "addr2": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        },
                        "addr1": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        },
                        "city": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        },
                        "state": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        }
                    }
                },
                "name": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "phone_number": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                }
            }
        },
        "payer": {
            "type": "object",
            "description": "Details of the payer",
            "properties": {
                "tin": {
                    "type": "string",
                    "description": "Tax identification number of the recipient"
                },
                "address": {
                    "type": "object",
                    "properties": {
                        "zipcode": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        },
                        "country": {
                            "type": "object",
                            "properties": {
                                "a2_code": {
                                    "type": "string",
                                    "examples": [
                                        "string"
                                    ]
                                },
                                "name": {
                                    "type": "string",
                                    "examples": [
                                        "string"
                                    ]
                                }
                            }
                        },
                        "addr2": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        },
                        "addr1": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        },
                        "city": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        },
                        "state": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        }
                    }
                },
                "gender": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "prefix": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "date_of_birth": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "last_name": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "middle_name": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "suffix": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "ssn": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "marital_status": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "full_name": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "nationality": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "phone_number": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "first_name": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "email": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                }
            }
        },
        "account_number": {
            "type": "string",
            "examples": [
                "string"
            ]
        },
        "transactions": {
            "type": "array",
            "items": {
    "title": "M1_FORM_1098 Schema",
    "type": "object",
    "description": "Representation of the 1098\n",
    "properties": {
        "mortgage_interest_received": {
            "type": "object",
            "properties": {
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                },
                "value": {
                    "type": "number",
                    "description": "Amount"
                }
            }
        },
        "outstanding_mortgage_principal": {
            "type": "object",
            "properties": {
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                },
                "value": {
                    "type": "number",
                    "description": "Amount"
                }
            }
        },
        "mortgage_origination_date": {
            "type": "string",
            "examples": [
                "string"
            ]
        },
        "refund_of_overpaid_interest": {
            "type": "object",
            "properties": {
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                },
                "value": {
                    "type": "number",
                    "description": "Amount"
                }
            }
        },
        "mortgage_insurance_premiums": {
            "type": "object",
            "properties": {
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                },
                "value": {
                    "type": "number",
                    "description": "Amount"
                }
            }
        },
        "points_paid_on_purchase_of_principal_residence": {
            "type": "object",
            "properties": {
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                },
                "value": {
                    "type": "number",
                    "description": "Amount"
                }
            }
        },
        "address_of_property_same_as_payers": {
            "type": "boolean",
            "examples": [
                false
            ]
        },
        "property_address": {
            "type": "object",
            "properties": {
                "zipcode": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "country": {
                    "type": "object",
                    "properties": {
                        "a2_code": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        },
                        "name": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        }
                    }
                },
                "addr2": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "addr1": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "city": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "state": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                }
            }
        },
        "number_of_properties_securing_the_mortgage": {
            "type": "number",
            "examples": [
                0
            ]
        },
        "other": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "number",
                    "examples": [
                        0
                    ]
                },
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                }
            }
        },
        "mortgage_acquisition_date": {
            "type": "string",
            "examples": [
                "string"
            ]
        }
    }
}
        },
        "totals": {
    "title": "M1_FORM_1098 Schema",
    "type": "object",
    "description": "Representation of the 1098\n",
    "properties": {
        "mortgage_interest_received": {
            "type": "object",
            "properties": {
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                },
                "value": {
                    "type": "number",
                    "description": "Amount"
                }
            }
        },
        "outstanding_mortgage_principal": {
            "type": "object",
            "properties": {
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                },
                "value": {
                    "type": "number",
                    "description": "Amount"
                }
            }
        },
        "mortgage_origination_date": {
            "type": "string",
            "examples": [
                "string"
            ]
        },
        "refund_of_overpaid_interest": {
            "type": "object",
            "properties": {
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                },
                "value": {
                    "type": "number",
                    "description": "Amount"
                }
            }
        },
        "mortgage_insurance_premiums": {
            "type": "object",
            "properties": {
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                },
                "value": {
                    "type": "number",
                    "description": "Amount"
                }
            }
        },
        "points_paid_on_purchase_of_principal_residence": {
            "type": "object",
            "properties": {
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                },
                "value": {
                    "type": "number",
                    "description": "Amount"
                }
            }
        },
        "address_of_property_same_as_payers": {
            "type": "boolean",
            "examples": [
                false
            ]
        },
        "property_address": {
            "type": "object",
            "properties": {
                "zipcode": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "country": {
                    "type": "object",
                    "properties": {
                        "a2_code": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        },
                        "name": {
                            "type": "string",
                            "examples": [
                                "string"
                            ]
                        }
                    }
                },
                "addr2": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "addr1": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "city": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                },
                "state": {
                    "type": "string",
                    "examples": [
                        "string"
                    ]
                }
            }
        },
        "number_of_properties_securing_the_mortgage": {
            "type": "number",
            "examples": [
                0
            ]
        },
        "other": {
            "type": "object",
            "properties": {
                "amount": {
                    "type": "number",
                    "examples": [
                        0
                    ]
                },
                "currency": {
                    "type": "string",
                    "enum": [
                        "USD"
                    ],
                    "description": "Currency"
                }
            }
        },
        "mortgage_acquisition_date": {
            "type": "string",
            "examples": [
                "string"
            ]
        }
    }
}
    }
}
/%}