Vendor tax documents

List vendor tax documents

Returns a page of the 1099-NEC documents generated for the company's vendors, with each document's amount, generation status and download URL.

GET

https://api.portal.magicdoor.com/company-app/vendors/tax-documents

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.

Query parameters

pageinteger

Which page to return. The first page is 1.

default: 1

pageSizeinteger

How many documents to return per page. Between 1 and 100.

default: 50

calendarYearinteger

Return only documents for this tax year.

taxTypeenum<string>

Return only documents of this form type. Vendor documents are misc for owners and nec for vendors.

miscnec

Response

200 · A page of tax documents.

itemsTaxDocument[]

The documents on this page.

currentPageinteger

The page this response is.

totalPagesinteger

How many pages the filter produces.

pageSizeinteger

How many documents a page holds.

totalCountinteger

How many documents match the filter across all pages.

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

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/vendors/tax-documents' \
  --header 'Authorization: Bearer <token>'

Response

{
  "items": [
    {
      "id": "1838110447398404096",
      "calendarYear": 2025,
      "taxDocumentType": "nec",
      "entityId": "1822910038475120640",
      "entityName": "Ridgeway Plumbing",
      "amount": 21400,
      "status": "completed",
      "documentName": "1099-nec-2025-ridgeway-plumbing.pdf",
      "documentUrl": "https://files.example-storage.net/tax/1838110447398404096.pdf?signature=opaque",
      "createdAt": "2026-01-15T09:00:00",
      "updatedAt": "2026-01-15T09:04:12"
    }
  ],
  "currentPage": 1,
  "totalPages": 1,
  "pageSize": 50,
  "totalCount": 18
}