---
title: "Get journal entries"
method: GET
path: "/api/ledger/journal"
tags: ["Journal"]
---

# Get journal entries

`GET /api/ledger/journal`

Retrieve journal entries by transfer ID or by account and date range.
**Mode 1 — By transferId:** returns all journals for a transfer.
**Mode 2 — By accountId + date range:** returns postings with cursor pagination.

## Query parameters

- `transferId` string, uuid
- `accountId` string
- `from` string, date
- `to` string, date
- `pageToken` string

## Headers

- `x-tenant-id` string, required

## Response `200`

Journal entries or postings

- union
  - JournalsByTransfer
    - `journals` JournalEntry[]
      - `journalId` string, uuid
      - `transferId` string, uuid
      - `eventType` string
      - `occurredAt` string, date-time
      - `memo` string, nullable
      - `postings` Posting[]
        - `debitAccountId` string
        - `creditAccountId` string
        - `amountMinor` string — Amount in minor units as string
        - `currency` string
        - `memo` string, nullable
  - PostingsByAccount
    - `postings` Posting[]
      - `debitAccountId` string
      - `creditAccountId` string
      - `amountMinor` string — Amount in minor units as string
      - `currency` string
      - `memo` string, nullable
    - `nextPageToken` string, nullable

## Other responses

- `400` — Validation error
- `401` — Missing or invalid authentication

---

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