Vendor bills

List vendor bills

Returns a page of the company's vendor bills, with every filter applied as an AND. Deleted bills are never included. Requires the vendor_bills:read permission.

GET

https://services.magicdoor.com/accounting/company-portal/vendor-bills

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

default: 50

companyBillboolean

true returns only bills the management company owes, false only bills an owner owes.

vendorIdsstring[]

Only bills from these vendors.

portfolioIdsstring[]

Only bills whose line items sit in these portfolios.

propertyIdsstring[]

Only bills whose line items sit on these properties.

unitIdsstring[]

Only bills whose line items sit on these units.

leaseIdsstring[]

Only bills whose line items sit on these leases.

ownerIdsstring[]

Only bills on properties these owners own. Resolved to property ids server-side and intersected with propertyIds if you also send that.

statusesenum<string>[]

Only bills in these approval states.

draftpendingapprovedrejectedwithdrawn

assignedToIdsstring[]

Only bills currently assigned to these property managers.

assignedByIdsstring[]

Only bills assigned by these property managers.

assignedAt.startstring · date-time

Earliest assignment time to include.

assignedAt.endstring · date-time

Latest assignment time to include.

assignedAt.startInclusiveboolean

Whether assignedAt.start itself is included.

default: true

assignedAt.endInclusiveboolean

Whether assignedAt.end itself is included.

default: true

billDate.startstring · date

Earliest bill date to include.

billDate.endstring · date

Latest bill date to include.

billDate.startInclusiveboolean

Whether billDate.start itself is included.

default: true

billDate.endInclusiveboolean

Whether billDate.end itself is included.

default: true

dueDate.startstring · date

Earliest due date to include.

dueDate.endstring · date

Latest due date to include.

dueDate.startInclusiveboolean

Whether dueDate.start itself is included.

default: true

dueDate.endInclusiveboolean

Whether dueDate.end itself is included.

default: true

totalAmount.startnumber

Smallest totalAmount to include, as a decimal.

totalAmount.endnumber

Largest totalAmount to include, as a decimal.

dueAmount.startnumber

Smallest dueAmount to include, as a decimal. Use dueAmount.start=0.01 for bills that still owe something.

dueAmount.endnumber

Largest dueAmount to include, as a decimal.

hasInvoicesboolean

true returns only bills that have at least one attached file, false only bills with none.

magicTagValuesstring[]

Only bills on properties carrying these MagicTags. Resolved to property ids server-side and intersected with propertyIds if you also send that.

searchstring

Free-text search, 1 to 150 characters. Matches the bill's memo or reference case-insensitively, and also returns bills whose property or vendor name matches.

Response

200 · A page of vendor bills.

itemsVendorBill[]

The bills on this page.

currentPageinteger

The page number that was returned.

totalPagesinteger

How many pages the filter produces at this pageSize.

pageSizeinteger

How many bills a full page holds.

totalCountinteger

How many bills match the filter in total.

400 · A query parameter failed validation — `page` below 1, `pageSize` outside 1–100, an id that is not a Snowflake, or a `search` longer than 150 characters.

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

403 · The caller does not hold the `vendor_bills:read` permission.

This page names its page differently

The envelope here is currentPage, totalPages, pageSize, totalCount, items — note currentPage, not page as on most list endpoints.