---
title: "Get debt line ledger balances"
method: GET
path: "/debt-lines/{id}/balances"
tags: ["Debt Lines"]
---

# Get debt line ledger balances

`GET /debt-lines/{id}/balances`

## Request

- Base URL: `https://core.sivo.com`
- URL: `https://core.sivo.com/debt-lines/{id}/balances`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://dashboard.sivo.com/oauth/authorize`
    - Client credentials
    - Token URL: `https://core.sivo.com/oauth/token`
- TypeScript: <https://skmtc.dev/sivo/apis/sivo-advance-api/docs/debt-lines/:id/balances/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required: An object id with prefix

## Response `200`

Successful operation

- object: List of items
  - `data` object[], required
    - `currency` string, required: currency of the balance amounts
    - `ledger` 'principal' | 'accrued' | 'fees' | 'collateral', required: type of ledger: principal tracks outstanding principal, accrued tracks accrued interest, fees tracks fees
    - `updated_at` string, date-time, required: date and time of last update
    - `settled_balance` integer, required: settled balance that excludes pending credits and debits
    - `settled_balance_usd` integer, required: settled balance in USD
    - `pending_increases` integer, required: pending increases in the balance
    - `pending_increases_usd` integer, required: pending increases in USD
    - `pending_decreases` integer, required: pending decreases in the balance
    - `pending_decreases_usd` integer, required: pending decreases in USD

## Changes

- **2026-11-03** `4bbab9699612`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sivo/apis/sivo-advance-api/changes/debt-lines/:id/balances/get.md)

---

[API](https://skmtc.dev/sivo/apis/sivo-advance-api.md) - [All operations](https://skmtc.dev/sivo/apis/sivo-advance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sivo/apis/sivo-advance-api/revisions/4bbab9699612?raw)