MagicDoorAPI
SupportOpen MagicDoor
Vendor tax documents

List vendor tax amounts for a year

Works out what each vendor was paid over a tax year and whether a 1099-NEC already exists, has gone stale, or cannot be filed because the vendor 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/vendors/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

vendorIdsstring[]

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

Response

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

accountIdstring

The vendor the figure is for.

calendarYearinteger

The tax year the figure covers.

amountnumber

What the vendor was paid over the year, in dollars and cents, rounded to the cent. This is what goes in box 1 of the 1099-NEC.

documentAlreadyExistsboolean

true when a 1099-NEC has already been generated for this vendor and year.

amountHasChangedboolean

true when the figure has moved since the existing document was generated, so it needs regenerating.

hasTaxIdboolean

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

vendorobject

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

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

404 · A vendor id in `vendorIds` does not exist for the caller's company.