MagicDoorAPI
SupportOpen MagicDoor
Manual reconciliations

List manual reconciliations

Returns every manual reconciliation recorded against one bank account, in progress, completed and cancelled. The list is not paginated and does not include entries. Requires the reconciliations:read permission.

GET
https://services.magicdoor.com/accounting/company-portal/bank-accounts/{bankAccountId}/manual-reconciliations

Authorization

Authorizationstringrequired
Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

bankAccountIdstringrequired

The bank account being reconciled.

example: 1830472847398404096

Response

200 · Every reconciliation for this bank account.

itemsManualReconciliation[]

The reconciliations, as summaries.

401 · The access token is missing, expired, or not for this company.

403 · The caller does not hold the `reconciliations:read` permission.

404 · No bank account with this id belongs to the caller's company.

How a manual reconciliation works

  1. Start a period

    Declare the statement date and the statement's own money-in and money-out totals. The period begins the day after the previous completed one ended.

  2. Pull in transactions

    Add the transactions the statement covers, each marked included or excluded. MagicDoor recomputes actualAdditions, actualSubtractions and actualClosing from the included ones.

  3. Close the gap

    Keep adding, removing and correcting until closingDifference is zero — the ledger and the statement now agree.

  4. Complete it

    Completing locks the period. Its closing becomes the next period's opening.