---
title: "List all journal entries"
method: GET
path: "/journal-entries/{booksId}"
tags: ["Books"]
---

# List all journal entries

`GET /journal-entries/{booksId}`

## Request

- Base URL: `https://api.mercury.com/api/v1`
- URL: `https://api.mercury.com/api/v1/journal-entries/{booksId}`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

## Path parameters

- `booksId` string, uuid, required

## Query parameters

- `time_zone` string
- `start_date` string, date: Only return Journal Entries after the start date (inclusive).
- `end_date` string, date: Only return Journal Entries before the end date (inclusive).
- `ledger_id` string, base58 (max length 22): Only return Journal Entries where at least one Line Entry belongs to the specified Ledger.
- `creation_source` 'manual' | 'transaction' | 'accrual' | 'legacy': Only return Journal Entries with the specified creation source.
- `sort` 'description' | '-description' | 'datetime' | '-datetime': A comma separated list of sort orders for the results.
- `expand` 'line_entries' | 'line_entries.transaction' | 'line_entries.ledger' | 'line_entries.opposing_ledger_ids' | 'line_entries.payment_applications': Comma-separated list of expandable paths.
- `page_token` string
- `keywords` string: Only return Journal Entries where the description matches the specified keyword(s).
- `amount` number, double: Only return journal entries with the specified monetary amount. If specified, `min_amount` and `max_amount` parameters are ignored. If no decimal place provided, rounded values will be matched. E.g. an input of `100` will match 100.13 and 100.45, but an input of `100.13` will only match that value.
- `min_amount` number, double: Only return journal entries with a monetary amount of at least the specified amount. Ignored if `amount` is set.
- `max_amount` number, double: Only return journal entries with a monetary amount less than specified amount. Ignored if `amount` is set.
- `ledger_id_groups` string[]: One or more comma-separated lists of ledger IDs. Only return Journal Entries where at least one Line Entry belongs to one of the specified ledgers in a group. Specifying multiple groups will return an intersection of the matches.
- `limit` integer: The maximum number of journal entries to return per page.

## Response `200`

## Other responses

- `400`: Invalid `limit` or `ledger_id_groups` or `max_amount` or `min_amount` or `amount` or `keywords` or `page_token` or `expand` or `sort` or `creation_source` or `ledger_id` or `end_date` or `start_date` or `time_zone`
- `404`: `booksId` not found

## Changes

- **2026-10-16** `ab652aa5aa8e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mercurytechnologies/apis/mercury-api/changes/journal-entries/:booksId/get.md)

---

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