---
schema_version: "1"
id: 40e8e5eda5f608d5ad63e2c4ac1a21cc20be559592f2e9fc453fc48eec21e4b7
title: Mortgage Application
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/financial_services_cloud_object_reference/connect_resources_get_patch_mortgage.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.financial_services_cloud_object_reference.meta/financial_services_cloud_object_reference/connect_resources_get_patch_mortgage.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: c7f1156c44c4b2a59ba4fe366d3d7d2c180a5e7d1d213fe7ded9a8446b936552
description: Use a single API call to get and update mortgage application information like borrowers, declarations, incomes, addresses, financial transactions, liabilities, assets, properties, and title holders. You can use both the loanApplicationId and the externalID of an external system to get a mortgage application.
---
# Mortgage Application

Use a single API call to get and update mortgage application information like borrowers, declarations, incomes, addresses, financial transactions, liabilities, assets, properties, and title holders. You can use both the loanApplicationId and the externalID of an external system to get a mortgage application.

## Resource

/connect/financialservices/mortgages/loanId

## Available Version

48.0

## Authentication

Use OAuth to connect to Salesforce and get an access token. Pass the access token in your requests.

## HTTP Methods

GET, PATCH

## Path Parameters

| Parameter Name | Type | Description | Required | Available version |
| --- | --- | --- | --- | --- |
| loanId | String | id or externalId associated with a loan application. | Yes | 48.0 |

## Request Body JSON Example

{
  "amortizationTerm": 30
}

## Response Body for GET and PATCH

| Property Name | Type | Description | Filter Group and Version | Available Version |
| --- | --- | --- | --- | --- |
| message | String | Error message, if any. | Small, 48.0 | 48.0 |
| result | [Mortgage Information Output](https://developer.salesforce.com/docs/atlas.en-us.financial_services_cloud_object_reference.meta/financial_services_cloud_object_reference/connect_responses_get_mortgage_result.htm "Represents the output of the GET method.")\[\] | Data of the mortgage result. | Small, 48.0 | 48.0 |

## Sample Response Body for GET and PATCH

{
  "result" : {
    "accountId" : "001RM000004Xra2YAC",
    "assets" : \[ \],
    "borrowers" : \[ \],
    "createdById" : "005RM000001vbghYAA",
    "createdDate" : "2019-11-06T19:29:10.000Z",
    "extendedFields" : \[ \],
    "externalId" : "tt2",
    "financials" : \[ \],
    "hasOtherLoanFeature" : false,
    "hasPrepaymentPenalty" : false,
    "id" : "0cdRM00000000n5YAA",
    "isBalloon" : false,
    "isBorrowerInCommunityPropState" : false,
    "isConstructionToPermanent" : false,
    "isContractForDeed" : false,
    "isDeleted" : false,
    "isEnergyRelatedImprovement" : false,
    "isInterestOnly" : false,
    "isNegativeAmortization" : false,
    "isPropInCommunityPropState" : false,
    "isRenovation" : false,
    "isSingleClosing" : false,
    "isSubjectToPriorityLien" : false,
    "isTempIntRateBuydown" : false,
    "lastModifiedById" : "005RM000001vbghYAA",
    "lastModifiedDate" : "2019-11-06T19:31:07.000Z",
    "lastReferencedDate" : "2019-11-06T19:35:31.000Z",
    "lastViewedDate" : "2019-11-06T19:35:31.000Z",
    "liabilities" : \[ \],
    "name" : "tt2",
    "ownerId" : "005RM000001vbghYAA",
    "properties" : \[ \],
    "systemModstamp" : "2019-11-06T19:31:07.000Z",
    "titleHolders" : \[ {
      "createdById" : "005RM000001vbghYAA",
      "createdDate" : "2019-11-06T19:29:10.000Z",
      "extendedFields" : \[ \],
      "externalId" : "tt1",
      "id" : "0cTRM000000009e2AA",
      "isCurrentTitleHolder" : false,
      "isDeleted" : false,
      "lastModifiedById" : "005RM000001vbghYAA",
      "lastModifiedDate" : "2019-11-06T19:31:07.000Z",
      "lastReferencedDate" : "2019-11-06T19:31:07.000Z",
      "lastViewedDate" : "2019-11-06T19:31:07.000Z",
      "loanApplicationId" : "0cdRM00000000n5YAA",
      "name" : "tt2",
      "systemModstamp" : "2019-11-06T19:31:07.000Z"
    } \]
  }
}