---
title: "Retrieve liabilities"
method: GET
path: "/v1/links/{link_id}/liabilities/"
tags: ["Liabilities"]
---

# Retrieve liabilities

`GET /v1/links/{link_id}/liabilities/`

The endpoint returns liability accounts including credit cards and loans with detailed balance and payment information.

## Path parameters

- `link_id` string, required

## Response `200`

- LiabilitiesResponse
  - `accounts` LiabilityAccount[] — List of liability accounts
    - `id` string — Unique ID
    - `created_at` string, date-time — Timestamp when the account was created in Truv
    - `updated_at` string, date-time — Timestamp when the account was updated last time in Truv
    - `type` 'LOAN' | 'CREDIT_CARD' | 'LINE_OF_CREDIT' | 'MORTGAGE' | 'CHECKING_LINE_OF_CREDIT', required — The account's type
    - `subtype` 'BROKERAGE' | 'STUDENT' | 'AUTO' | 'PERSONAL' | 'PERSONAL_WITH_COLLATERAL' | 'HELOC' | 'HOME_EQUITY' | 'RV' | 'SMALL_BUSINESS' | 'ESTATE' | 'EDUCATIONAL' | 'CERTIFICATE_OF_DEPOSIT' | 'INDIVIDUAL' | 'BOAT' | 'POWERSPORTS' | 'null', nullable, required — The account's subtype
    - `mask` string, nullable, required — Last 4 digits of account number
    - `nickname` string, nullable — Description of account
    - `balances` AccountBalances, required
      - `currency_code` string, nullable — Currency
      - `balance` string, decimal, nullable — Balance amount
      - `available_balance` string, decimal, nullable — Available balance amount
      - `credit_limit` string, decimal, nullable — Credit limit
  - `liabilities` Liabilities
    - `credit` CreditLiability[] — List of credit cards and lines of credit liabilities
      - `account_id` string, required — Unique account identifier
      - `advances_apr` string, decimal, nullable — Annual Percentage Rate for cash advances
      - `purchases_apr` string, decimal, nullable — Annual Percentage Rate for purchases
      - `available_cash` string, decimal, nullable — Available cash advance amount
      - `available_credit` string, decimal, nullable — Available credit amount
      - `balance_as_of` string, date-time, nullable — Date and time when the balance was last updated
      - `credit_line` string, decimal, nullable — Total credit line amount
      - `current_balance` string, decimal, nullable — Current outstanding balance
      - `last_payment_amount` string, decimal, nullable — Amount of the last payment made
      - `last_payment_date` string, date, nullable — Date of the last payment
      - `last_stmt_balance` string, decimal, nullable — Balance from the last statement
      - `last_stmt_date` string, date, nullable — Date of the last statement
      - `minimum_payment_amount` string, decimal, nullable — Minimum payment amount due
      - `next_payment_amount` string, decimal, nullable — Next payment amount due
      - `next_payment_date` string, date, nullable — Next payment due date
      - `past_due_amount` string, decimal, nullable — Amount that is past due
    - `loans` LoanLiability[] — List of loan liabilities
      - `account_id` string, required — Unique account identifier
      - `balance_as_of` string, date-time, nullable — Date and time when the balance was last updated
      - `escrow_balance` string, decimal, nullable — Current escrow balance (for mortgages)
      - `interest_paid_year_to_date` string, decimal, nullable — Total interest paid year to date
      - `interest_rate` string, decimal, nullable — Current interest rate as a percentage
      - `interest_rate_as_of` string, date-time, nullable — Date when the interest rate was last updated
      - `last_payment_amount` string, decimal, nullable — Amount of the last payment made
      - `last_payment_date` string, date-time, nullable — Date of the last payment
      - `loan_term` integer, nullable — Total loan term in months
      - `maturity_date` string, date-time, nullable — Date when the loan matures
      - `next_payment_amount` string, decimal, nullable — Next payment amount due
      - `next_payment_date` string, date-time, nullable — Next payment due date
      - `original_principal` string, decimal, nullable — Original principal amount of the loan
      - `principal_balance` string, decimal, nullable — Current principal balance remaining

## Other responses

- `401` — HTTP 401 Unauthorized
- `403` — HTTP 403 Forbidden
- `404` — HTTP 404 Not Found

## Changes

- **2026-07-27** `f7c013875516` — 21 info
  - the `accounts/items/balances/available_balance` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `accounts/items/balances/balance` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `accounts/items/balances/credit_limit` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - the `liabilities/credit/items/advances_apr` response's property pattern `^-?\d{1,10}\.\d{2}$` was added for the status `200`
  - …17 more
- **2026-07-26** `e58688835e25` — 2 breaking, 7 warning
  - the response property `accounts/items/balances/currency_code` became nullable for the status `200`
  - the `liabilities/loans/items/loan_term` response's property type changed from `string` to `integer` for status `200`
  - added the new `BOAT` enum value to the `accounts/items/subtype` response property for the response status `200`
  - added the new `CERTIFICATE_OF_DEPOSIT` enum value to the `accounts/items/subtype` response property for the response status `200`
  - …5 more

[Change history](https://skmtc.dev/truv/apis/truv-api/changes/v1/links/:link_id/liabilities/get.md)

---

[API](https://skmtc.dev/truv/apis/truv-api.md) · [All operations](https://skmtc.dev/truv/apis/truv-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/truv/truv-api/revisions/68ca293bce44/schema)