Skip to main content
POST
Confirm a bank-match

Authorizations

X-API-KEY
string
header
required

Headers

Idempotency-Key
string

Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.

Maximum string length: 255

Body

application/json

Body for POST /matches/. Pair bank-feed row(s) with DualEntry target(s).

Use the singular fields for a 1:1 match, or the plural fields (financial_transaction_ids + transaction_ids/entry_ids) for an M:N match. Don't mix a singular field with its plural counterpart.

financial_transaction_id
integer | null

ID of the bank-feed row to match (from /bank-transactions/).

transaction_id
integer | null

DualEntry transaction id to match against. Pass this or entry_id, not both.

entry_id
integer | null

DualEntry entry id to match against (use for partial matches like a single line of a journal entry). Pass this or transaction_id.

financial_transaction_ids
integer[] | null

M:N: bank-feed row ids to match as one group. Same account and same sign.

transaction_ids
integer[] | null

M:N: DualEntry transaction ids for the group. May be combined with entry_ids.

entry_ids
integer[] | null

M:N: DualEntry entry ids for the group. May be combined with transaction_ids.

Response

OK

success
boolean
default:true
errors
Errors · object
match_group_id
integer | null
Last modified on August 21, 2026