---
title: "List journals"
method: GET
path: "/api/v1/iqbooks/organisations/{organisationId}/journals"
tags: ["IQ Books — Journals"]
---

# List journals

`GET /api/v1/iqbooks/organisations/{organisationId}/journals`

## Request

- Base URL: `https://api.reconcileiq.com`
- URL: `https://api.reconcileiq.com/api/v1/iqbooks/organisations/{organisationId}/journals`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Entry-level paginated list of journal entries. Filters: `?search`, `?date_from`, `?date_to`, `?source_system`, `?status`, `?account_id`, `?limit`/`?offset`. Requires scope `iqbooks:read`.

## Path parameters

- `organisationId` integer, required

## Query parameters

- `limit` integer
- `offset` integer
- `search` string
- `date_from` string, date
- `date_to` string, date
- `source_system` string
- `status` string
- `account_id` integer

## Response `200`

Journal entries.

- object
  - `data` JournalSummary[], required
    - `id` integer
    - `je_number` integer, nullable
    - `entry_date` string, date, nullable
    - `description` string, nullable
    - `status` string
    - `source_system` string, nullable
    - `source_reference` string, nullable
    - `amount` number, nullable
    - `primary_vat_code` string, nullable
    - `total_vat_amount` number, nullable
    - `posted_at` string, date-time, nullable
  - `pagination` object, required
    - `limit` integer, required
    - `offset` integer, required
    - `count` integer, required: Number of rows in this page (data.length).
    - `total` integer: Total matching rows when the native service reports it; may be absent.

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `403`: Authenticated but the key lacks the required scope.
- `404`: Resource not found, or not visible to the caller (no existence leak).

---

[API](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api.md) · [All operations](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api/revisions/5401beef8653?raw)