---
title: "List journal entries"
method: GET
path: "/v1/platform/businesses/{business_id}/general-ledger/journal-entries/"
tags: ["General Ledger"]
---

# List journal entries

`GET /v1/platform/businesses/{business_id}/general-ledger/journal-entries/`

## Request

- Base URL: `https://docs.thredfi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.thredfi.com/v1/platform/businesses/{business_id}/general-ledger/journal-entries/`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP basic
  - HTTP bearer
  - HTTP bearer

List all journal entries for a business with comprehensive filtering.

        **Features:**
        - Filter by date range (date_from, date_to)
        - Filter by account (entries affecting a specific account)
        - Filter by status (draft, approved, rejected)
        - Filter by created_by (ai, manual, system, import)
        - Filter by posted status
        - Search by description, reference, or sequence number
        - Pagination support (default: 20 per page, max: 100)

        **Response includes:**
        - Entry sequence number, date, reference, description
        - Total debit and credit amounts
        - Balance status
        - Status and creation metadata
        - Posted status and timestamp
        - Source document type and reference (invoice, bill, payment, etc.)

## Path parameters

- `business_id` string, uuid, required

## Query parameters

- `account_id` string, uuid
- `created_by` string
- `date_from` string, date
- `date_to` string, date
- `is_posted` boolean
- `page` integer
- `page_size` integer
- `search` string
- `status` string

## Response `200`

- PaginatedJournalEntryListList
  - `count` integer, required: Total number of items
  - `page_info` object, required
    - `total_count` integer, required: Total number of items (same as count)
    - `current_page` integer, required: Current page number (1-indexed)
    - `total_pages` integer, required: Total number of pages
    - `page_size` integer, required: Number of items per page
  - `results` JournalEntryList[], required
    - `id` string, uuid, required: Unique journal entry identifier
    - `sequence_number` string, required: Sequential journal entry number (e.g., 'JE-2024-0042')
    - `entry_date` string, date, required: Date of the journal entry (YYYY-MM-DD)
    - `reference` string, required: Journal entry reference number or source document reference
    - `description` string, required: Journal entry description
    - `currency` string, required: Entry currency from business base currency (GBP, EUR, USD)
    - `total_debit` integer, required: Total debit amount in cents (sum of all debit lines)
    - `total_credit` integer, required: Total credit amount in cents (sum of all credit lines)
    - `is_balanced` boolean, required: Whether debits equal credits (balanced entry required for posting)
    - `created_by` 'ai' | 'manual' | 'system' | 'import', required: Creator type: ai, manual, system, import * `ai` - AI System * `manual` - Manual Entry * `system` - System Generated * `import` - Data Import
    - `created_by_display` string, required: Human-readable creator type
    - `status` 'draft' | 'approved' | 'rejected', required: Entry status: draft, approved, rejected * `draft` - Draft * `approved` - Approved * `rejected` - Rejected
    - `status_display` string, required: Human-readable status
    - `is_posted` boolean, required: Whether entry is posted to ledger (affects account balances)
    - `posted_at` string, date-time, nullable, required: Timestamp when entry was posted to ledger (null if not posted)
    - `bank_transaction_id` string, nullable, required: Linked bank transaction UUID (null if not from bank feed)
    - `source_type` string, nullable, required: Source document type (invoice, bill, payment, bank_transaction, etc.)
    - `source_reference` string, nullable, required: Source document reference number
    - `created_at` string, date-time, required: Timestamp when entry was created

## Other responses

- `400`: Validation errors in request data
- `401`: Authentication required - missing or invalid API key
- `403`: Permission denied - insufficient privileges
- `404`: Resource not found
- `409`: Conflict - resource already exists or invalid state transition
- `422`: Unprocessable entity - business logic validation failed
- `500`: Internal server error

---

[API](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api.md) - [All operations](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/revisions/0c1918254db3?raw)