Company

Check the company's setup status

Returns ten yes-or-no answers about how far the company has got with setup: whether it has a chat phone number, submitted business details, connected a bank, and configured the payment settings for invoices, rent, deposits and rental applications.

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

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.

Response

200 · The setup checks.

phoneNumberSettledboolean

Whether the company has a phone number it can send and receive chat messages on.

businessInfoSubmittedboolean

Whether a primary business information record has been submitted for the company.

hasBankAccountsboolean

Whether the company has a bank connection at all. True when either plaidConnected or stripeConnected is true, because an early bank account may not have account numbers recorded yet.

plaidConnectedboolean

Whether a Plaid bank ledger exists for the company.

stripeConnectedboolean

Whether a Stripe connected account exists for the company and has finished submitting its details.

hasPaymentAccountsboolean

Whether the company has a payment account of its own.

invoiceSettingsConfiguredboolean

Whether both a payment method and a bank account with a cash chart of account are set for MagicDoor invoices.

rentPaymentSettingsConfiguredboolean

Whether a bank account is set for rent payments.

depositPaymentSettingsConfiguredboolean

Whether a bank account is set for security deposits.

rentalApplicationSettingsConfiguredboolean

Whether a bank account is set for rental application fees.

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