Management fees

Get a management fee

Fetches one management fee with its per-property lines, the credits and payout applied to each, and the properties, units, leases, transactions, bank accounts, chart of accounts and files it refers to.

GET
https://api.portal.magicdoor.com/company-app/management-fees/{managementFeeId}

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

managementFeeIdstringrequired

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

example: 1831110447398404096

Response

200 · The management fee.

idstring

The management fee. A Snowflake id sent as a decimal string.

chargeDatestring · date

The day the fee was charged.

periodStartstring · date

The first day of the period the fee covers.

periodEndstring · date

The last day of the period the fee covers.

totalAmountnumber

What the fee comes to in dollars and cents. Positive — money the property owes the management company.

creditedAmountnumber

How much of it has been covered by management fee credits.

paidAmountnumber

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

outstandingAmountnumber

What is left: the fee less credit and payment. Zero means it is fully settled.

memostring

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

referencestring

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

companyVendorIdstring

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

lineItemsobject[]

The fee broken down by property, in display order.

filesobject[]

Files attached to the fee.

metadataobject

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

createdstring · date-time

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

updatedstring · date-time

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

creatorobject

Who created the record.

vendorobject

The vendor record standing for the management company, resolved.

portfoliosobject[]

The portfolios the fee's lines belong to, resolved.

propertiesobject[]

The properties the fee's lines are charged to, resolved.

unitsobject[]

The units the fee's lines refer to, resolved.

leasesobject[]

The leases the fee's lines refer to, resolved.

transactionsobject[]

The accounting transactions behind the credits and payouts, resolved.

bankAccountsobject[]

The bank accounts those transactions moved money through, resolved. Account and routing numbers are masked.

chartOfAccountsobject[]

The chart of accounts the fee 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 management fee with that id exists for the caller's company.