---
title: "List ledger entries"
method: GET
path: "/v1/ledger/entries"
tags: ["Ledger"]
---

# List ledger entries

`GET /v1/ledger/entries`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/ledger/entries`
- Auth: HTTP bearer

Lists ledger entries for your team, newest first.

### Filters

- scope (matches either side of the entry)
- kind
- the reference that caused the entry

### Profile-scoped access

A profile-scoped key (or a member limited to some profiles) only sees entries of campaigns under its profiles and of their participants. Operator and platform scopes stay hidden from it.

## Query parameters

- `scopeType` string
- `scopeId` string
- `kind` 'accrual' | 'approval' | 'hold_release' | 'adjustment' | 'settling' | 'settlement' | 'reversal' | 'topup' | 'transfer' | 'fee'
- `referenceType` string
- `referenceId` string
- `limit` integer
- `skip` integer

## Response `200`

Ledger entries

- object
  - `entries` object[]
    - `id` string
    - `kind` 'accrual' | 'approval' | 'hold_release' | 'adjustment' | 'settling' | 'settlement' | 'reversal' | 'topup' | 'transfer' | 'fee'
    - `amountCents` integer: Always positive; direction is given by debit and credit
    - `debit` LedgerAccountSide
      - `scopeType` string
      - `scopeId` string
      - `bucket` string
    - `credit` LedgerAccountSide
      - `scopeType` string
      - `scopeId` string
      - `bucket` string
    - `holdUntil` string, date-time, nullable
    - `releasedByEntryId` string, nullable
    - `referenceType` string, nullable
    - `referenceId` string, nullable
    - `reversesEntryId` string, nullable
    - `cause` string
    - `actor` string
    - `createdAt` string, date-time
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `skip` integer

## Other responses

- `400`: Invalid request
- `403`: The API key is a restricted key (zrk_ prefix) and may not perform this operation. Three cases: 1. The operation's resource group (see the operation's x-resource-group) is disabled on the key. Fix: create a key with the group enabled in the dashboard API keys tab and revoke the old one. 2. The operation is admin-plane (x-resource-group admin-plane: API keys, invites, connected apps, member identity), never grantable to restricted keys. The error reads "Restricted API keys cannot manage API keys, invites, or member identity." Fix: a full-access key or the dashboard, never a new restricted key. 3. On webhook subscription writes, delivery-log reads and replays, a named event maps to a resource group the key does not hold. A restricted key can never create or edit a subscription broader than itself (a no-messages key cannot subscribe to, test-fire, redeliver or read logs for message.* events).

## Changes

- **2026-10-28** `8f2c44dd7550`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ledger/entries/get.md)

---

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