Checks

List checks

Returns a page of the checks the company has written, together with the bank accounts, vendors, owners and tenants those checks refer to so the list can be rendered without extra lookups.

GET
https://api.portal.magicdoor.com/company-app/checks

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. The first page is 1.

default: 1
pageSizeinteger

How many checks to return per page. Between 1 and 100.

default: 50
checkIdentityenum<string>

Return only checks written for this kind of payment: a vendor bill, an owner distribution, a payout to the management company, or the release of a lease balance.

vendorBillownerDistributioncompanyPayoutleaseBalanceRelease
vendorIdsstring[]

Return only checks made out to these vendors. Repeat the parameter for each vendor id.

ownerIdsstring[]

Return only checks made out to these owners. Repeat the parameter for each owner id.

tenantIdsstring[]

Return only checks made out to these tenants. Repeat the parameter for each tenant id.

bankAccountIdsstring[]

Return only checks drawn on these bank accounts. Repeat the parameter for each bank account id.

dateFromstring · date

Return only checks dated on or after this day.

dateTostring · date

Return only checks dated on or before this day.

amount.fromnumber

Lower bound of the check amount. Give at least one of amount.from and amount.to when filtering by amount, or the request is rejected.

amount.tonumber

Upper bound of the check amount.

amount.includeFromboolean

Whether a check whose amount equals amount.from is included.

default: true
amount.includeToboolean

Whether a check whose amount equals amount.to is included.

default: true
memostring

Return only checks whose memo matches this text.

transactionIdsstring[]

Return only the checks tied to these accounting transactions. Repeat the parameter for each transaction id.

voidedboolean

true returns only voided checks, false only checks that are still good. Omit it to get both.

Response

200 · A page of checks plus the records they point at.

itemsCheck[]

The checks on this page.

currentPageinteger

The page this response is.

totalPagesinteger

How many pages the filter produces.

pageSizeinteger

How many checks a page holds.

totalCountinteger

How many checks match the filter across all pages.

bankAccountsBankAccount[]

Every bank account referenced by items[].bankAccountId, so the list can show the account a check was drawn on. Account and routing numbers are masked to their last four digits.

vendorsVendor[]

Every vendor referenced by items[].vendorId. Each entry is the full vendor record.

ownersOwner[]

Every owner referenced by items[].ownerId. Each entry is the full owner record.

tenantsTenant[]

Every tenant referenced by items[].tenantId. Each entry is the full tenant record.

401 · The access token is missing, expired, or does not belong to a property manager.