Vendor bill payments

List bills that can be paid

Returns the vendor bills that still have money outstanding, grouped by the property whose funds would pay them, along with each property's available balance, reserve and default bank account, and the vendors' Plaid payment accounts.

GET
https://api.portal.magicdoor.com/company-app/vendors/bills/pay

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

billIdsstring[]

Only consider these bills. Repeat the parameter for each id. Sending it with no values returns an empty result rather than everything.

propertyIdsstring[]

Only consider bills charged to these properties. Repeat the parameter for each id. Sending it with no values returns an empty result.

vendorIdsstring[]

Only consider bills owed to these vendors. Repeat the parameter for each id. Sending it with no values returns an empty result.

companyBillboolean

true limits the result to bills the management company owes out of its own money; false to property expenses. Omit for both.

dueDate.startstring · date

Only consider bills due on or after this day. Give at least one of dueDate.start and dueDate.end, and start must not be after end.

dueDate.endstring · date

Only consider bills due on or before this day.

Response

200 · The bills that can be paid, grouped by the property that funds them, plus the company's own bills and the vendors involved.

propertiesobject[]

One entry per property that has outstanding bills, with the money available to pay them from that property's funds.

companyVendorBillsVendorBill[]

Outstanding bills the management company owes out of its own money. Each carries a property when all its lines point at exactly one property.

vendorsobject[]

The vendors owed money, each with its payment accounts. Only payment accounts held with Plaid are included — those are the ones ACH can be sent to.

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

404 · A property or vendor referenced by the matching bills does not belong to the caller's company.