Emails

List a vendor's emails

Returns a page of the emails your company has sent to a vendor, newest first.

GET

https://api.portal.magicdoor.com/company-app/emails/vendors/{vendorId}

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

vendorIdstringrequired

The vendor whose emails you want.

example: 1825337204880932864

Query parameters

pageinteger

Which page to return. The first page is 1.

default: 1example: 1

pageSizeinteger

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

default: 50example: 25

Response

200 · One page of emails.

itemsEmailSummary[]

The emails, newest page first.

currentPageinteger

The page number that was returned.

totalPagesinteger

How many pages exist at this page size.

pageSizeinteger

How many items a page holds.

totalCountinteger

How many items match in total, across every page.

tenantsTenant[]

The tenants referenced by items[].targets.

leasesLease[]

The leases referenced by items[].targets.

ownersOwner[]

The owners referenced by items[].targets.

vendorsVendor[]

The vendors referenced by items[].targets.

propertyManagersPropertyManager[]

The property managers referenced by items[].propertyManagerId.

401 · The access token is missing, expired, or not valid.

404 · No vendor with that id belongs to your company.

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/emails/vendors/1825337204880932864?page=1&pageSize=25' \
  --header 'Authorization: Bearer <token>'

Response

{
  "items": [
    {
      "id": "1831287365623406592",
      "subject": "Water shut-off Thursday",
      "body": "<p>Water will be off Thursday 9am to 1pm for a repair.</p>",
      "sent": "2026-08-17T14:05:00",
      "template": "companyGeneric",
      "targets": [
        {
          "email": "marcus.webb@example.com",
          "tenantId": "1827991044238376960",
          "leaseId": "1829833104612495360"
        }
      ],
      "propertyManagerId": "1820011923988709376"
    }
  ],
  "currentPage": 1,
  "totalPages": 1,
  "pageSize": 25,
  "totalCount": 8,
  "tenants": [
    {
      "id": "1827991044238376960",
      "active": true,
      "firstName": "Marcus",
      "lastName": "Webb",
      "email": "marcus.webb@example.com",
      "phone": "(208) 555-0117",
      "language": "en",
      "chatId": "1830472847398404096",
      "portalStatus": "active",
      "lastSeen": "2026-08-16T19:41:07",
      "icons": [],
      "created": "2026-02-11T10:05:33",
      "updated": "2026-07-30T16:22:09"
    }
  ],
  "leases": [
    {
      "id": "1829833104612495360",
      "portfolioId": "1823772785993383936",
      "propertyId": "1824559920033832960",
      "unitId": "1828440183928913920",
      "start": "2026-03-01",
      "end": "2027-02-28",
      "ended": false,
      "monthToMonth": false,
      "eviction": false,
      "draft": false,
      "status": "lease",
      "expiringStatus": "none",
      "chatId": "1830472847398404096",
      "tenants": [
        {
          "tenantId": "1827991044238376960",
          "moveIn": "2026-03-01"
        }
      ],
      "balance": 0,
      "postedBalance": 0,
      "currentRent": 1850,
      "securityDepositRequested": 1850,
      "securityDepositPaid": 1850,
      "securityDepositDue": 0,
      "lastPaymentDate": "2026-08-01",
      "icons": []
    }
  ],
  "owners": [],
  "vendors": [],
  "propertyManagers": [
    {
      "id": "1820011923988709376",
      "companyId": "1810119284757463040",
      "email": "dana@brightsidepm.com",
      "phone": "(208) 555-0142",
      "firstName": "Dana",
      "lastName": "Ortiz",
      "name": "Dana Ortiz",
      "active": true,
      "created": "2025-11-03T08:20:15",
      "lastSeen": "2026-08-17T13:58:02"
    }
  ]
}