List journal entries
Operation ID: journalEntries
Group: Accounting › Journal Entries
Open in the interactive reference
GET /accounting/journal-entries
Read-only: Reads and returns; changes nothing.
Lists journal entries. Each journal entry in the list has no lines. To read a journal entry with its lines, use GET accounting/journal-entries/:id or POST accounting/journal-entries/search.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Api-Version |
header | string · v1 | yes | The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1. |
Query surface
id— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likestatus— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, liketype— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likepostingDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, betweenbookName— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likelastModifiedDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, between- Orderable: id, status, type, postingDate, bookName, lastModifiedDate
- Selectable: id, name, status, type, approvalStatus, postingDate, reversalDate, reversalReason, reversalDescription, description, url, bookName, lastModifiedDate
page[size]— Page sizepage[cursor]— Opaque continuation cursor
Response
200 Success
Under data, an array of journalEntriesRow:
| Field | Type | Required | Filter | Sort | Description |
|---|---|---|---|---|---|
id |
string | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | The unique identifier for the journal entry. |
name |
string | null | no | no | no | The display name of the journal entry. |
status |
string | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | The posting status of the journal entry. Possible values: 'posted', 'unposted', 'voided'. |
type |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | How the entry originated, for example 'manual', 'invoice', 'revaluation' or 'reversal'. A system-assigned value. |
approvalStatus |
string | null | no | no | no | The approval status of the journal entry. Possible values: 'draft', 'pendingApproval', 'revise', 'approved', 'rejected'. Absent on entries that never entered the approval workflow. |
postingDate |
date | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) |
yes | The date the entry posts to the general ledger. Format YYYY-MM-DD. |
reversalDate |
date | null | no | no | no | The reversal date recorded on the entry. Format YYYY-MM-DD. Set only on a reversed entry or a reversal entry. |
reversalReason |
string | null | no | no | no | The reason recorded for the reversal. Possible values: 'accrualReversal', 'revaluationReversal', 'estimate', 'rebook', 'reversingSFD', 'other'. |
reversalDescription |
string | null | no | no | no | The description recorded on the reversal. |
description |
string | null | no | no | no | A free-form description of the journal entry. |
url |
string | null | no | no | no | A link to the source document this entry comes from. |
bookName |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | The name of the accounting book this entry posts to. See name on GET accounting/books/:id. |
lastModifiedDate |
date-time | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) |
yes | The date and time the journal entry last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. |
{
"data": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "<name>",
"status": "<status>",
"type": "<type>",
"approvalStatus": "<approvalStatus>",
"postingDate": "2026-01-15",
"reversalDate": "2026-01-15",
"reversalReason": "<reversalReason>",
"reversalDescription": "<reversalDescription>",
"description": "<description>",
"url": "<url>",
"bookName": "<bookName>",
"lastModifiedDate": "2026-01-15T09:30:00.000Z"
}
],
"pagination": {
"hasMore": true,
"nextCursor": "<nextCursor>"
}
}
Statuses
400— Invalid request or business failure401— The request carries no valid access token.403— Not authorized404— Not found429— Too many requests from this client address. The response has no body and noRetry-Afterheader.500— Internal server error