Banking

Apply one category to many bank transactions

Applies one account (and optional contact, tax rate, and class) to up to 200 ready or posted bank transactions. Each row uses the single-row reclassify rules: ready rows are coded but not posted, posted rows update their category line, and rows in a completed reconciliation are refused. Posted invoice or bill payments and posted rows whose other line is Accounts Receivable, Accounts Payable, or another bank or cash account are skipped (skipped: true on the result) because their category cannot change without an Undo. An omitted taxRateId, contactId, or classId keeps the row's current value; null clears it. Failures are reported per row and never stop the batch. Rule learning follows each change.

post/bank-transactions/categorize-batch

Request

  • Base URL: https://ledgerhq.pro/api/v1
  • URL: https://ledgerhq.pro/api/v1/bank-transactions/categorize-batch
  • Auth: one of:
    • HTTP bearer and API key in header x-organization-id
    • HTTP bearer and API key in header x-organization-id

Request body

transactionIdsstring[] required
accountIdstring uuid required
contactIdstring uuid nullable
taxRateIdstring uuid nullable
classIdstring uuid nullable
reasonstring

Response

Per-transaction results

Changes

No recorded changes to this operation across all 5 revisions of this API.