Confirm bank import

POSThttps://app.speybooks.com/api/v1/bank-imports/{id}/confirm

Confirms selected rows from a bank import, creating double-entry transactions for each. Rows are categorised using the rules engine where possible; unmatched rows are posted to the Suspense account (9999).

Pass rowAccountMap to override the suggested account for specific rows. Pass defaultAccountId to use a different fallback account instead of Suspense.

After confirmation, the import status changes to completed and the stored file data is cleared. Unselected rows are marked as skipped.

Path parameters

idstringrequired
Bank import ID (e.g. bimp_42).

Body parameters

rowsarray<integer>required
Array of statement row IDs to import. At least one required.
defaultAccountIdstringoptional
Default category account ID (e.g. acc_9999). Falls back to Suspense (9999) if omitted.
rowAccountMapobjectoptional
Per-row account overrides. Keys are row IDs (as strings), values are account IDs (e.g. {"42": "acc_4000"}).

Response

200Import confirmed. Returns created and skipped counts.
Show response fields
createdinteger
importIdstring
skippedinteger
totalinteger

Error codes

400No rows selected or Suspense account not found.
404Import not found.
409Import already completed or all selected rows already imported.