---
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

---

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