MagicDoorAPI
SupportOpen MagicDoor
Owner tax documents

List owner tax amounts for a year

Works out what each owner was paid over a tax year and whether a 1099-MISC already exists, has gone stale, or cannot be filed because the owner has no tax id on file. Nothing is created — feed the figures into the batch-create endpoint.

GET
https://api.portal.magicdoor.com/company-app/owners/tax-documents/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

calendarYearintegerrequired

The tax year to work out figures for.

example: 2025

Query parameters

ownerIdsstring[]

Only work out figures for these owners. Repeat the parameter for each id. Left out, every owner is included.

Response

200 · One entry per owner, as a bare array. This endpoint is not paginated.

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 · An owner id in `ownerIds` does not exist for the caller's company.