Checks

Get a check

Fetches one check with everything needed to print it: the bank account it is drawn on, the company writing it, the payee, and the MICR line.

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

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

checkIdstringrequired

The check to fetch. A Snowflake id sent as a decimal string.

example: 1830472847398404096

Response

200 · The check, with the records it refers to embedded.

idstring

The check.

companyIdstring

The management company that wrote the check.

checkNumberinteger

The number printed on the check.

vendorIdstring

The vendor the check is made out to. Absent when the payee is not a vendor.

ownerIdstring

The owner the check is made out to. Absent when the payee is not an owner.

tenantIdstring

The tenant the check is made out to. Absent when the payee is not a tenant.

bankAccountIdstring

The bank account the check is drawn on. Money leaves this account when the check clears.

amountnumber

The face value of the check, in dollars and cents — money paid out by the company.

amountStringstring

The same amount written out in words, as printed on the check line.

memostring

The memo printed on the check. Absent when none was set.

datestring · date-time

The date printed on the check, in the company's timezone.

createdOnstring · date-time

When the check record was created, in the company's timezone.

transactionIdstring

The accounting transaction this check paid. Absent when the check is not tied to one.

voidedboolean

true once the check has been voided.

voidReasonstring

Why the check was voided. Absent unless a reason was given.

dataHeadersstring[]

Column headings for the stub table printed under the check. Each entry in billPayments[].data is keyed by one of these headings.

billPaymentsobject[]

One row per item the check pays, as printed on the stub.

bankAccountobject

The account the check is drawn on. Account and routing numbers are masked to their last four digits.

companyobject

The management company whose name and address are printed on the check.

vendorobject

The vendor payee, as the full vendor record. Absent when the payee is not a vendor.

ownerobject

The owner payee, as the full owner record. Absent when the payee is not an owner.

tenantobject

The tenant payee, as the full tenant record. Absent when the payee is not a tenant.

micrCodestring

The magnetic ink line printed along the bottom of the check. It is composed as c<checkNumber>c A<routingNumber>A <accountNumber>C and carries the bank account's full routing and account numbers, unlike the bankAccount object above, which masks both to their last four digits. Omitted from the example here for that reason.

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

404 · No check with that id exists for the caller's company. A check belonging to another company reads the same way.