Reconciliation items

List reconciliation items

Returns a page of the company's reconciliation items as summaries, without candidates, links or resolved reference names. Requires the reconciliations:read permission.

GET

https://services.magicdoor.com/accounting/company-portal/reconciliations/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.

Query parameters

pageinteger

Which page to return, starting at 1.

default: 1

pageSizeinteger

How many items per page, between 1 and 100.

default: 50

bankAccountIdstring

Only items on this bank account.

statusesenum<string>[]

Only items in these states.

openneedsReviewcompleted

resolutionTypesenum<string>[]

Only items resolved in these ways. Unresolved items never match.

matchedsettledpostedignored

reviewReasonsenum<string>[]

Only items with an open review for these reasons.

sourceModifiedAfterResolutionsourceRemovedAfterResolutionaccountingTargetChangedAfterResolution

occurred.startstring · date

Earliest bank-entry date to include, read as a whole day in the company's timezone.

occurred.endstring · date

Latest bank-entry date to include, read as a whole day in the company's timezone.

occurred.startInclusiveboolean

Whether occurred.start itself is included.

default: true

occurred.endInclusiveboolean

Whether occurred.end itself is included.

default: true

Response

200 · A page of reconciliation items.

itemsReconciliationItem[]

The items on this page.

totalCountinteger

How many items match the filter in total.

totalPagesinteger

How many pages that is at this pageSize.

pageinteger

The page number that was returned.

pageSizeinteger

How many items a full page holds.

400 · A query parameter failed validation — `page` below 1, `pageSize` outside 1–100, or an id that is not a Snowflake.

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

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

What a reconciliation item is

One line on the bank statement, waiting to be explained. MagicDoor creates an item for every entry the bank feed reports and keeps it until you say what it was: a transaction already in the books (matched), a payment of vendor bills (settled), a transaction that should now be created (posted), or nothing MagicDoor needs to record (ignored).

`status`	What it means	What you can do
`open`	No resolution yet.	Resolve it, or ask for fresh suggestions.
`needsReview`	It was resolved, then something underneath changed — the bank edited or withdrew the entry, or a linked transaction moved.	Acknowledge the review, or rematch to start over.
`completed`	Resolved and nothing outstanding.	Rematch if you need to redo it, unless it is locked in a period.