---
title: "Journal Entries · Practice Manager API · COUNT Partner API"
description: "Journal entries are manual double-entry postings to the general ledger. Each posting has a memo, date, optional reference number, and balanced debit/credit…"
canonical: "https://developers.getcount.com/practice-manager/reference/journal-entries"
source: "https://developers.getcount.com/practice-manager/reference/journal-entries"
---
Practice Manager API

# Journal Entries

Journal entries are manual double-entry postings to the general ledger. Each posting has a memo, date, optional reference number, and balanced debit/credit lines that reference chart-of-accounts UUIDs.

Last updated 2026-11-18

## Overview

The Journal Entries API lets your integration list, read, create, bulk-create, update, and delete manual journal postings in a workspace. Each posting must balance: every line carries exactly one of `amountDebit` or `amountCredit`, never both and never neither.

Partner mutation bodies use `accountUuid` on each line (the `id` from chart of accounts). System-generated entries from invoices, bills, payroll, and other integrations are read-only — update and delete return 400 for those sources.

## Key concepts

### Balance checks

Each line requires `accountUuid` plus exactly one of `amountDebit` or `amountCredit`. Create and bulk create accept a posting whose debits do not equal its credits, for period-close accruals, payroll clearing and imports, so check balance yourself if you need it. Update rejects an unbalanced `lines` array with 400. Postings COUNT builds for bills, invoices and transactions are always balanced.

### Account UUID resolution

Copy account UUIDs from chart of accounts (`id`, `accUuid`, or `accountUuid` fields — any UUID-shaped value from list accounts works). Do not pass numeric internal account ids.

### Manual entries only

Only manually-created entries (and Square integration entries) can be updated or deleted. System-generated entries return 400.

### Bulk partial success

Bulk create processes up to 100 postings independently. Response: `{ successCount, errorCount, results: [{ index, success, journalEntry? | error? }] }` with HTTP 201 even when some rows fail.

## The journal entry line object

List and mutation responses return an array of lines sharing the same `journalLinkUuid`. Each line represents one debit or credit leg.

#### Attributes

`id` uuid

Line identifier (UUID). Pass in the path to update or delete the posting group anchor line.

`descriptionEntry` string

Posting memo shared across all lines in the entry.

`descriptionLine` string

Optional per-line description.

`date` date

Posting date (ISO YYYY-MM-DD).

`refNumber` string

Optional reference number.

`amountDebit` string

Debit amount as a decimal string, or null when this line is a credit.

`amountCredit` string

Credit amount as a decimal string, or null when this line is a debit.

`accountUuid` uuid

Chart-of-accounts UUID for this line.

`account` object

Embedded account summary when included on list responses.

`journalLinkUuid` uuid

Shared link id grouping all lines in the same posting.

`createdAt` datetime

ISO 8601 creation timestamp.

`updatedAt` datetime

ISO 8601 last update timestamp.

Example

```json
{
  "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
  "descriptionEntry": "Accrue March rent",
  "descriptionLine": "Rent expense",
  "date": "2026-03-01",
  "refNumber": "JE-2026-003",
  "amountDebit": "2500.00",
  "amountCredit": null,
  "accountUuid": "c8d9e0f1-a2b3-4567-cdef-789012345678",
  "account": {
    "id": "c8d9e0f1-a2b3-4567-cdef-789012345678",
    "name": "Rent Expense",
    "type": "Expenses"
  },
  "journalLinkUuid": "a9b8c7d6-e5f4-3210-abcd-ef9876543210",
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-28T14:22:30.000Z"
}
```

withCaution bypasses period checks

Pass `withCaution: true` on create (sparingly) to skip book-closeness checks. Manual entries can still fail when a line posts into a reconciled period for that account.

Bulk performance

Bulk create resolves all account UUIDs in a single batched lookup across the whole batch — prefer bulk over repeated single creates for large imports (~25 postings per batch recommended).

Update replaces all lines

PATCH sends the full replacement `lines` array with the same shape as create. Partial line patches are not supported.

Three ways to send a file

JSON `attachments` entries take a public `url` (COUNT downloads and keeps a copy) or the file inline as `contentBase64` (up to 10 MB). The `/upload` routes take `multipart/form-data`. All three are held to the same per-file cap and file types, at most 10 files a request, and every file is virus-scanned before anything is saved. To read a file back without following a link, call the attachment's `/content` route, which returns it base64-encoded.

File links are signed per response

Any `documentUrl`, `receiptUrl`, `pdfUrl` or `bankStatementUrl` on COUNT storage comes back as a short-lived signed link, minted only after COUNT proves the file belongs to this workspace. Use it straight away and call again for a fresh one; do not store it. A file COUNT cannot prove is the workspace's comes back as `null`. A link you attached to an outside file is returned exactly as you sent it.

## Related

- [Chart of Accounts API](https://developers.getcount.com/practice-manager/reference/chart-of-accounts)
- [Transactions API](https://developers.getcount.com/practice-manager/reference/transactions)

## Endpoints

[GET List journal entries `/firm-partners/workspace/journal-entries` Returns a paginated list of journal entry lines.](https://developers.getcount.com/practice-manager/reference/journal-entries/list-journal-entries) [GET Get a journal entry `/firm-partners/workspace/journal-entries/{uuid}` Returns one posting with every line, in entry order.](https://developers.getcount.com/practice-manager/reference/journal-entries/get-journal-entry) [POST Create journal entry `/firm-partners/workspace/journal-entries` Creates a manual journal entry posting.](https://developers.getcount.com/practice-manager/reference/journal-entries/create-journal-entry) [POST Bulk create journal entries `/firm-partners/workspace/journal-entries/bulk` Creates up to 100 journal entry postings in one request with partial-success semantics.](https://developers.getcount.com/practice-manager/reference/journal-entries/bulk-create-journal-entries) [PATCH Update journal entry `/firm-partners/workspace/journal-entries/{uuid}` Updates a manually-created journal entry by UUID.](https://developers.getcount.com/practice-manager/reference/journal-entries/update-journal-entry) [DELETE Delete journal entry `/firm-partners/workspace/journal-entries/{uuid}` Deletes a journal entry posting by UUID.](https://developers.getcount.com/practice-manager/reference/journal-entries/delete-journal-entry) [GET List journal entry attachments `/firm-partners/workspace/journal-entries/{uuid}/attachments` Lists the files attached to a manual journal entry.](https://developers.getcount.com/practice-manager/reference/journal-entries/list-journal-entry-attachments) [POST Add journal entry attachments `/firm-partners/workspace/journal-entries/{uuid}/attachments` Adds files to a manual journal entry from public URLs or inline base64 content.](https://developers.getcount.com/practice-manager/reference/journal-entries/add-journal-entry-attachments) [POST Upload journal entry attachments `/firm-partners/workspace/journal-entries/{uuid}/attachments/upload` Adds files to a manual journal entry via multipart form data.](https://developers.getcount.com/practice-manager/reference/journal-entries/upload-journal-entry-attachments) [DELETE Delete journal entry attachment `/firm-partners/workspace/journal-entries/{uuid}/attachments/{attachmentUuid}` Removes one attachment from a manual journal entry.](https://developers.getcount.com/practice-manager/reference/journal-entries/delete-journal-entry-attachment) [GET Get journal entry attachment content `/firm-partners/workspace/journal-entries/{uuid}/attachments/{attachmentUuid}/content` Returns a journal entry attachment's file, base64-encoded, with its note.](https://developers.getcount.com/practice-manager/reference/journal-entries/get-journal-entry-attachment-content)
