# Loan Payment Details
source: https://developer.mastercard.com/open-finance-us/documentation/products/manage/loan-payment-details/index.md

## Overview {#overview}

Loan Payment Details retrieves the information needed to move money to a non-routable liability account, as well as provide a 10-day future payoff amount, depending on the availability by the financial institution. This is a billable service, where a charge is incurred for each successful API call.

## How it Works {#how-it-works}

After a customer has added accounts in [Mastercard Data Connect](https://developer.mastercard.com/open-finance-us/documentation/connect/index.md), Loan Payment Details can be retrieved from a financial institution. Our list of Supported Institutions confirms payment detail availability.

**Get Loan Payment Details**


API Reference: `GET /aggregation/v2/customers/{customerId}/accounts/{accountId}/loanDetails`

<br />

The following fields in the response are required fields: `loanNumber`, `loanPaymentNumber`, and `loanPaymentAddress`. If one of these fields are not available, the API call will not be successful. The futurePayoffAmount and futurePayoffDate fields (for account, group, or loan) are optional, meaning if the field is available, it will be returned in the API response, but if is not available, the call may still be successful.

### Student Loan Data {#student-loan-data}

For Certified Student Loan Institutions, use the account ID of the studentLoanAccount account `type` as the input parameter for `accountId`. This will enable a consolidated response to return the payment details of the entire sub-structure consisting of the `studentLoanGroup` and `studentLoan` accounts. Using the account ID of the incorrect account type will result in a failed call. Certified Student Loan Institutions can be identified via Supported Institutions.

## Good to Know {#good-to-know}

Even though an institution may support Loan Payment Details, there are some account types at that institution may not be supported.

**Common API Status Codes**

| HTTP Code |                         Meaning                         |                                                            Resolution                                                            |
|-----------|---------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------|
| 20010     | Loan number not found                                   | Submit a [support ticket](https://finicity.atlassian.net/servicedesk/customer/portal/13)                                         |
| 20011     | Loan payment number not found                           | Submit a [support ticket](https://finicity.atlassian.net/servicedesk/customer/portal/13)                                         |
| 20022     | Loan payment address not found                          | Submit a [support ticket](https://finicity.atlassian.net/servicedesk/customer/portal/13)                                         |
| 38008     | Account details not found                               | Submit a [support ticket](https://finicity.atlassian.net/servicedesk/customer/portal/13)                                         |
| 38003     | Customer does not have given account                    | Resubmit with a correctly related customerId and accountId                                                                       |
| 44000     | Timeout - The request has been accepted for processing. | Try again later. If the issue persists, submit a [support ticket](https://finicity.atlassian.net/servicedesk/customer/portal/13) |