Start free trial

Split a transaction across categories

PATCH/api/v1/transactions/{transaction_id}/split

Rebuild a transaction's journal entry so its single category leg becomes multiple category legs (e.g. 70% COGS / 30% Sales Tax). Allocations may be percentages, fixed amounts, or a remainder line; the resulting legs always balance against the bank leg.

Operation ID: split_transaction_api_v1_transactions__transaction_id__split_patch·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

transaction_idstringrequired

Request body

Schema: TransactionSplitRequest

splitarray · SplitAllocationrequiredSplitAllocation

Category allocations (at least 2 lines).

7 fields
ledger_idstringrequired

Category ledger for this leg

allocation_typeSplitAllocationTyperequiredSplitAllocationType

percent | amount | remainder

valueinteger

Basis points for 'percent' (70% == 7000), cents for 'amount', ignored/None for 'remainder'.

descriptionstring

Optional per-line memo

class_idstring

Optional Class dimension

location_idstring

Optional Location dimension

project_idstring

Optional Project for job costing

Responses

200Successful Response

Schema: SuccessEnvelope_TransactionListResponse_

successboolean
messagestring
codestring
dataTransactionListResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject