Manual reconciliations

Get a manual reconciliation

Fetches one reconciliation with its entries, the totals computed from them, and how far they are from what was declared. Requires the reconciliations:read permission.

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

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
manualReconciliationIdstringrequired

Snowflake id of the reconciliation.

example: 1830472847398409100

Response

200 · The reconciliation, its entries and its balance comparison.

idstring

Snowflake id of the reconciliation.

bankAccountIdstring

The bank account being reconciled.

startDatestring · date

The first day of the period, which is the day after the previous completed period ended. Absent on the company's very first reconciliation for this account, which has no lower bound.

endDatestring · date

The statement date the period is being reconciled to.

openingnumber

The balance the account started the period with, as a decimal. On any reconciliation after the first this is copied from the previous completed period's closing and cannot be overridden.

additionsnumber

The total money in that the bank statement shows, as a positive decimal. This is what you declare, not what MagicDoor computed.

subtractionsnumber

The total money out that the bank statement shows, as a positive decimal. Declared, not computed.

closingnumber

opening plus additions minus subtractions. MagicDoor keeps it in step with those three; you never send it.

statusenum<string>

inProgress while it is being worked on, then completed or cancelled.

inProgresscompletedcancelled
creatorobject

Who started the reconciliation. Deprecated mirrors of id — propertyManagerId, tenantId, vendorId, ownerId — are also present, whichever matches type.

memostring

Free-text note. Absent when none was set.

createdstring · date-time

When the reconciliation was started, in the company's timezone.

updatedstring · date-time

When it last changed, in the company's timezone.

entriesEntry[]

Every transaction pulled into the reconciliation, included or excluded.

actualAdditionsnumber

The sum of the included entries whose direction is in. Compare against additions.

actualSubtractionsnumber

The sum of the included entries whose direction is out. Compare against subtractions.

actualClosingnumber

opening plus actualAdditions minus actualSubtractions — the balance the ledger says the account should have.

additionsDifferencenumber

actualAdditions minus additions. Positive means the ledger has more money in than the statement declares.

subtractionsDifferencenumber

actualSubtractions minus subtractions. Positive means the ledger has more money out than the statement declares.

closingDifferencenumber

actualClosing minus closing. It must be exactly zero before the reconciliation can be completed.

depositSlipsDepositSlip[]

The deposit slips the entries belong to, so you can group by slip instead of by transaction.

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

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

404 · The bank account is not in the caller's company, or no reconciliation with this id belongs to that bank account.

additions, subtractions and closing are what the bank statement says. actualAdditions, actualSubtractions and actualClosing are what the included entries add up to. The three *Difference fields are actual minus declared, so zero everywhere means the two agree.