MagicDoorAPI
SupportOpen MagicDoor
Manual journal entries

List manual journal entries

Returns a page of the company's manual journal entries with every chart-of-account entry their lines refer to. Deleted entries are never included. Requires the manual_journal_entries:read permission.

GET
https://services.magicdoor.com/accounting/company-portal/manual-journal-entries

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 entries per page, between 1 and 100.

default: 50
postingDate.startstring · date

Earliest posting date to include, read in the company's timezone.

postingDate.endstring · date

Latest posting date to include, read in the company's timezone.

postingDate.startInclusiveboolean

Whether postingDate.start itself is included.

default: true
postingDate.endInclusiveboolean

Whether postingDate.end itself is included.

default: true
descriptionstring

Match against the entry description, 1 to 1000 characters.

statusesenum<string>[]

Only entries in these states.

draftpendingApprovalapprovedpostedrejected
createdByUserIdsstring[]

Only entries created by these property managers.

submittedByUserIdsstring[]

Only entries submitted by these property managers.

approvedByUserIdsstring[]

Only entries approved by these property managers.

postedByUserIdsstring[]

Only entries posted by these property managers.

rejectedByUserIdsstring[]

Only entries rejected by these property managers.

submittedAt.startstring · date

Earliest submission date to include.

submittedAt.endstring · date

Latest submission date to include.

approvedAt.startstring · date

Earliest approval date to include.

approvedAt.endstring · date

Latest approval date to include.

postedAt.startstring · date

Earliest posting-action date to include. This is when someone pressed post, not the entry's postingDate.

postedAt.endstring · date

Latest posting-action date to include.

rejectedAt.startstring · date

Earliest rejection date to include.

rejectedAt.endstring · date

Latest rejection date to include.

chartOfAccountIdsstring[]

Only entries with a line hitting one of these accounts.

ownerIdsstring[]

Only entries with a line attributed to these owners.

portfolioIdsstring[]

Only entries with a line attributed to these portfolios.

propertyIdsstring[]

Only entries with a line attributed to these properties.

unitIdsstring[]

Only entries with a line attributed to these units.

leaseIdsstring[]

Only entries with a line attributed to these leases.

tenantIdsstring[]

Only entries with a line attributed to these tenants.

vendorIdsstring[]

Only entries with a line attributed to these vendors.

Response

200 · A page of manual journal entries.

itemsManualJournalEntry[]

The entries on this page. Unlike the single-entry response these do not each carry chartOfAccounts — the resolved accounts for the whole page sit alongside items.

totalCountinteger

How many entries match the filter in total.

totalPagesinteger

How many pages the filter produces at this pageSize.

pageinteger

The page number that was returned.

pageSizeinteger

How many entries a full page holds.

chartOfAccountsChartOfAccount[]

Every chart-of-account entry referenced by any line on this page, resolved once.

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 `manual_journal_entries:read` permission.