MagicDoorAPI
SupportOpen MagicDoor
Reconciliation periods

List a period's items

Returns a page of the bank feed entries inside a period and how each was resolved. For a locked period this comes from the snapshot taken at lock time, not from live data. Requires the reconciliations:read permission.

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

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

Query parameters

pageinteger

Which page to return, starting at 1.

default: 1
pageSizeinteger

How many entries per page, between 1 and 100.

default: 50
statusenum<string>

Only items in this state. One value, not a list.

openneedsReviewcompleted
resolutionTypeenum<string>

Only items resolved this way. One value, not a list.

matchedsettledpostedignored
hasReviewboolean

true returns only items with a review attached, false only items without one.

Response

200 · A page of the period's items.

sourceenum<string>

live for a draft or reopened period, so the rows reflect the current state; lockedSnapshot for a locked period, so they reflect what was true at lock time and will not move.

livelockedSnapshot
lockedstring · date-time

When the snapshot was taken, in the company's timezone. Present only when source is lockedSnapshot.

itemsPeriodItem[]

One row per bank feed entry in the period.

totalCountinteger

How many entries match the filter in total.

totalPagesinteger

How many pages that is at this pageSize.

pageinteger

The page number that was returned.

pageSizeinteger

How many entries a full page holds.

400 · A pagination value is out of range.

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

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

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