---
title: "List balance movements"
method: GET
path: "/user_ledger_entries"
tags: ["UserLedgerEntries"]
---

# List balance movements

`GET /user_ledger_entries`

Returns the individual entries behind your account balance: refills, payments, and label/subscription charges, each with the running balance immediately after it -- your account statement.

Reads directly from the account's own records, so a just-booked entry appears immediately.

Two ways to page through results: page/per_page for browsing a bounded range, or before_id for walking a large account's full history -- see the before_id parameter below.

## Query parameters

- `created_at_min` string, date-time
- `created_at_max` string, date-time
- `reference_type` 'shipment' | 'payment_request' | 'payment_requests' | 'generic_payment' | 'generic_payments' | 'sales_header' | 'subscription_period' | 'shipment_case'
- `source_type` 'sales_document' | 'transaction'
- `settlement_id` integer
- `per_page` integer
- `page` integer
- `before_id` integer

## Response `200`

Successful.

- UserLedgerEntry[]
  - `id` integer — Unique identifier of the object.
  - `created_at` string, date-time — When the entry was booked.
  - `amount` string, nullable — Signed movement in the account's own currency. Positive for a refill or payment, negative for a charge.
  - `currency_code` string, nullable — ISO 4217 currency code.
  - `balance` string, nullable — The account's running balance immediately after this entry.
  - `description` string, nullable — Human readable description of the entry, in the account's own language.
  - `reference_type` 'shipment' | 'payment_request' | 'payment_requests' | 'generic_payment' | 'generic_payments' | 'sales_header' | 'subscription_period' | 'shipment_case', nullable — What the entry relates to. Null when the entry has no reference.
  - `reference_id` integer, nullable — ID of the record named by reference_type, in that record's own resource.
  - `source_type` 'sales_document' | 'transaction', nullable — Whether the entry is a charge (sales_document) or a refill/payment (transaction). Null for an entry with no source record.
  - `settlement_id` integer, nullable — ID of the entry this one settles, when applicable. Null for most entries.

## Other responses

- `401` — Unauthorized.
- `422` — A filter value could not be parsed.

## Changes

- **2026-09-03** `c787692a7961` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/shipmondo/apis/shipmondo-api/changes/user_ledger_entries/get.md)

---

[API](https://skmtc.dev/shipmondo/apis/shipmondo-api.md) · [All operations](https://skmtc.dev/shipmondo/apis/shipmondo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shipmondo/apis/shipmondo-api/revisions/597a3e53ac0d?raw)