Service bills

Get a service bill

Fetches one service bill with its line, the payout that drew it out, and the property, unit, lease, transactions, bank accounts, chart of accounts and files it refers to.

GET
https://api.portal.magicdoor.com/company-app/service-bills/{serviceBillId}

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

serviceBillIdstringrequired

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

example: 1836110447398404096

Response

200 · The service bill.

idstring

The service bill. A Snowflake id sent as a decimal string.

chargeDatestring · date

The day the charge is dated.

totalAmountnumber

What the bill comes to in dollars and cents. Positive — money the property owes the management company for work beyond the management agreement.

paidAmountnumber

How much of it has been drawn out to the company.

outstandingAmountnumber

What is left: totalAmount less paidAmount.

memostring

A note on the bill. Absent when none was set.

referencestring

A reference on the bill. Absent when none was set.

companyVendorIdstring

The vendor record standing for the management company itself, which the bill is billed from.

lineItemsobject[]

The bill broken down by property, in display order.

filesobject[]

Files attached to the bill.

metadataobject

Free-form key-value pairs kept on the bill.

createdstring · date-time

When the bill was created, in the company's timezone.

updatedstring · date-time

When it last changed, in the company's timezone.

creatorobject

Who created the bill.

vendorobject

The vendor record standing for the management company, resolved.

portfoliosobject[]

The portfolios the lines belong to, resolved.

propertiesobject[]

The properties the lines charge, resolved.

unitsobject[]

The units the lines refer to, resolved.

leasesobject[]

The leases the lines refer to, resolved.

transactionsobject[]

The accounting transactions behind the payouts, resolved.

bankAccountsobject[]

The bank accounts those transactions moved money through, resolved. Account and routing numbers are masked to their last four digits.

chartOfAccountsobject[]

The chart of accounts the bill books to, resolved.

hydratedFilesobject[]

The attachments in files, resolved to full file records with signed download URLs.

creatorInfoobject

The person behind creator, resolved. Exactly one of propertyManager, vendor, tenant and owner is present, matching creator.type.

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

404 · No service bill with that id exists for the caller's company.