Reconciliation periods

Reopen a reconciliation period

Unfreezes a locked period so its items can be worked on again. Requires the reconciliations:write permission.

POST

https://services.magicdoor.com/accounting/company-portal/reconciliations/periods/{reconciliationPeriodId}/reopen

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

reconciliationPeriodIdstringrequired

Snowflake id of the reconciliation period.

example: 1830472847398411100

Response

200 · The period, now `reopened`, with `locked` cleared.

idstring

Snowflake id of the period.

bankAccountIdstring

The bank account this period covers.

periodStartstring · date

First day of the period, in the company's timezone.

periodEndstring · date

Last day of the period, in the company's timezone.

openingBalancenumber

The bank's balance at the start of the period, as a decimal.

closingBalancenumber

The bank's balance at the end of the period, as a decimal, taken from the statement.

statusenum<string>

draft while being prepared, locked once closed, reopened after a locked period has been opened up again. Both draft and reopened are editable.

draftreopenedlocked

validityStatusenum<string>

Only meaningful once locked. valid when nothing outstanding affects it; invalidated when it has an unacknowledged disposition of its own; impacted when an earlier period is invalidated, so this one's numbers are indirectly in doubt. A draft or reopened period is always valid.

validinvalidatedimpacted

dispositionsDisposition[]

Things that changed after this period was locked and are waiting to be acknowledged.

lockedstring · date-time

When the period was locked, in the company's timezone. Absent while it is draft or reopened.

createdstring · date-time

When the period was created, in the company's timezone.

updatedstring · date-time

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

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

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

404 · No reconciliation period with this id belongs to the caller's company.

422 · The period cannot be reopened — most often because it was never locked. Read `capabilities.canReopen` and the `blockers` with `action: "reopen"` on the period.

Later periods are reopened too

You cannot leave a hole in the timeline. Reopening a period also reopens every locked period after it on the same bank account — the response only returns the one you asked for, so re-read the list to see the rest. The lock history is kept: lockSummary.lockCount still counts the earlier locks, and locking again appends a new snapshot.