Confirm bank import

POST https://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

id string required
Bank import ID (e.g. bimp_42).

Body parameters

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

Response

200 Import confirmed. Returns created and skipped counts.
Show response fields
created integer
importId string
skipped integer
total integer

Error codes

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