---
title: "Get ledger balances"
method: GET
path: "/terms/balances"
tags: ["Terms"]
---

# Get ledger balances

`GET /terms/balances`

## Query parameters

- `currency` string — ISO 4217 currency code

## Response `200`

Successful operation

- object — List of items
  - `data` object[], required
    - `currency` string, required — currency of the balance amounts
    - `ledger` 'payout' | 'payin' | 'reserve', required — type of ledger: payout is the amount that sivo owes the seller. payin is the amount that seller owes to sivo.
    - `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. for example, a pending payin credit represents receivables that are due in the future.
    - `pending_increases_usd` integer, required — pending increases in USD
    - `pending_decreases` integer, required — pending decreases in the balance. for example, a pending payin debit represents debit transfers that are in progress.
    - `pending_decreases_usd` integer, required — pending decreases in USD

---

[API](https://skmtc.net/sivo/apis/sivo-advance-api.md) · [All operations](https://skmtc.net/sivo/apis/sivo-advance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sivo/sivo-advance-api/versions/bfbcd2bfed61/schema)