Introduction to Liabilities

Access data for student loans, mortgages, and credit cards using the Liabilities product.

Explore API

API Reference

View Liabilities requests, responses, and example code

View Liabilities API

Quickstart

Learn about Plaid's key concepts and run starter code

Get started

Overview

Plaid's Liabilities product allows you to access information about a user's debts. Common applications include loan decisioning as well as personal financial management tools to help customers manage or refinance debt.

Liabilities data

With Liabilities, you can view account information for credit cards, PayPal credit accounts, student loans, and mortgages in the US. Available information includes balance, next payment date and amount, loan terms such as duration and interest rate, and originator information such as the origination date and initial loan amount. Liabilities data is refreshed approximately once per day, and the latest data can be accessed by calling /liabilities/get.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
"credit": [
  {
    "account_id": "dVzbVMLjrxTnLjX4G66XUp5GLklm4oiZy88yK",
    "aprs": [
      {
        "apr_percentage": 15.24,
        "apr_type": "balance_transfer_apr",
        "balance_subject_to_apr": 1562.32,
        "interest_charge_amount": 130.22
      },
      {
        "apr_percentage": 27.95,
        "apr_type": "cash_apr",
        "balance_subject_to_apr": 56.22,
        "interest_charge_amount": 14.81
      },
      {
        "apr_percentage": 12.5,
        "apr_type": "purchase_apr",
        "balance_subject_to_apr": 157.01,
        "interest_charge_amount": 25.66
      },
      {
        "apr_percentage": 0,
        "apr_type": "special",
        "balance_subject_to_apr": 1000,
        "interest_charge_amount": 0
      }
    ],
    "is_overdue": false,
    "last_payment_amount": 168.25,
    "last_payment_date": "2019-05-22",
    "last_statement_balance": 1708.77,
    "last_statement_issue_date": "2019-05-28",
    "minimum_payment_amount": 20,
    "next_payment_due_date": "2020-05-28"
  }
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
"student": [
  {
    "account_id": "Pp1Vpkl9w8sajvK6oEEKtr7vZxBnGpf7LxxLE",
    "account_number": "4277075694",
    "disbursement_dates": [
      "2002-08-28"
    ],
    "expected_payoff_date": "2032-07-28",
    "guarantor": "DEPT OF ED",
    "interest_rate_percentage": 5.25,
    "is_overdue": false,
    "last_payment_amount": 138.05,
    "last_payment_date": "2019-04-22",
    "last_statement_balance": 138.05,
    "last_statement_issue_date": "2019-04-28",
    "loan_name": "Consolidation",
    "loan_status": {
      "end_date": "2032-07-28",
      "type": "repayment"
    },
    "minimum_payment_amount": 25,
    "next_payment_due_date": "2019-05-28",
    "origination_date": "2002-08-28",
    "origination_principal_amount": 25000,
    "outstanding_interest_amount": 6227.36,
    "payment_reference_number": "4277075694",
    "pslf_status": {
      "estimated_eligibility_date": "2021-01-01",
      "payments_made": 200,
      "payments_remaining": 160
    },
    "repayment_plan": {
      "description": "Standard Repayment",
      "type": "standard"
    },
    "sequence_number": "1",
    "servicer_address": {
      "city": "San Matias",
      "country": "US",
      "postal_code": "99415",
      "region": "CA",
      "street": "123 Relaxation Road"
    },
    "ytd_interest_paid": 280.55,
    "ytd_principal_paid": 271.65
  }
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
"mortgage": [
  {
    "account_id": "BxBXxLj1m4HMXBm9WZJyUg9XLd4rKEhw8Pb1J",
    "account_number": "3120194154",
    "current_late_fee": 25.0,
    "escrow_balance": 3141.54,
    "has_pmi": true,
    "has_prepayment_penalty": true,
    "interest_rate": {
      "percentage": 3.99,
      "type": "fixed",
    },
    "last_payment_amount": 3141.54,
    "last_payment_date": "2019-08-01",
    "loan_term": "30 year",
    "loan_type_description": "conventional",
    "maturity_date": "2045-07-31",
    "next_monthly_payment": 3141.54,
    "next_payment_due_date": "2019-11-15",
    "origination_date": "2015-08-01",
    "origination_principal_amount": 425000,
    "past_due_amount": 2304,
    "property_address": {
      "city": "Malakoff",
      "country": "US",
      "postal_code": "14236",
      "region": "NY",
      "street": "2992 Cameron Road",
    }
    "ytd_interest_paid": 12300.4,
    "ytd_principal_paid": 12340.5
  }
]

Payment history

The information returned by a /liabilities/get request contains recent payment information, such as the date and amount of the most recent payment. To view further payment history, you can use Plaid's Transactions product.

Testing Liabilities

Liabilities can be tested in Sandbox without any additional permissions. In order to test Liabilities against live Items in Development or Production, you will need to first request access by submitting a product access request Support ticket explaining your use case.