Owner tax documents

Get one owner's tax amounts for a year

Works out what a single owner was paid over a tax year and whether a 1099-MISC already exists or has gone stale. Nothing is created.

GET
https://api.portal.magicdoor.com/company-app/owners/tax-documents/{ownerId}/amounts/{calendarYear}

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

ownerIdstringrequired

The owner to work out figures for. A Snowflake id sent as a decimal string.

example: 1812910038475120640
calendarYearintegerrequired

The tax year to work out figures for.

example: 2025

Response

200 · The owner's figures for that year. The body is empty when the owner had no activity in the year.

accountIdstring

The owner the figures are for.

calendarYearinteger

The tax year the figures cover.

rentAmountnumber

Rents paid to the owner over the year, in dollars and cents, rounded to the cent. This is what goes in box 1 of the 1099-MISC.

otherAmountnumber

Other income paid to the owner over the year, in dollars and cents, rounded to the cent.

documentAlreadyExistsboolean

true when a 1099-MISC has already been generated for this owner and year.

amountHasChangedboolean

true when the figures have moved since the existing document was generated, so it needs regenerating.

hasTaxIdboolean

true when the owner has federal tax information on file. A 1099 cannot be filed without it.

ownerobject

The owner, as the full owner record. Absent when the owner could not be resolved.

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

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