Tenants

List a tenant's payments

Returns a page of money-in transactions recorded against this tenant — payments, and the returns, refunds and disputes that follow them. Money going out is not included.

GET

https://api.portal.magicdoor.com/company-app/tenants/{tenantId}/payments

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

tenantIdstringrequired

The tenant. A Snowflake id, sent as a decimal string.

example: 1830472847398404096

Query parameters

pageinteger

Which page to return. Starts at 1. Note the asymmetry: the parameter is page, but the response reports it back as currentPage.

default: 1example: 1

pageSizeinteger

How many records per page. Between 1 and 100.

default: 50example: 50

Response

200 · A page of transactions, plus the records they refer to.

currentPageinteger

The page returned. Note the name: this envelope calls it currentPage, not page.

totalPagesinteger

How many pages the filter matches.

pageSizeinteger

How many records were asked for per page.

totalCountinteger

How many records the filter matches in total.

itemsTransaction[]

The records on this page.

bankAccountsobject[]

The bank accounts referenced on this page.

chartOfAccountsobject[]

The chart-of-accounts lines referenced on this page.

propertiesobject[]

The properties referenced on this page.

unitsobject[]

The units referenced on this page.

leasesobject[]

The leases referenced on this page.

tenantsobject[]

The tenants referenced on this page.

vendorsobject[]

The vendors referenced on this page.

subsidizersobject[]

The subsidizers referenced on this page.

ownersobject[]

The owners referenced on this page.

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

An unknown tenant gives an empty page

This endpoint filters transactions by tenant id rather than looking the tenant up first, so an id that does not exist, or belongs to another company, returns an empty page rather than 404.

Money in only

The filter is fixed to incoming transactions. Payouts, vendor bills and other outgoing movements never appear here, whichever tenant they mention.

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/tenants/1830472847398404096/payments?page=1&pageSize=50' \
  --header 'Authorization: Bearer <token>'

Response

{
  "currentPage": 1,
  "totalPages": 1,
  "pageSize": 50,
  "totalCount": 2,
  "items": [
    {
      "id": "1830472847398404900",
      "created": "2026-08-01T07:15:22",
      "updated": "2026-08-03T02:10:04",
      "creator": {
        "type": "tenant",
        "id": "1830472847398404096",
        "deleted": false,
        "source": "autoPay",
        "tenantId": "1830472847398404096"
      },
      "type": "payment",
      "identity": "leaseCharge",
      "direction": "in",
      "amount": 1850,
      "paymentMethod": "ach",
      "status": "success",
      "transactionDate": "2026-08-01",
      "finalizedDate": "2026-08-03",
      "memo": "August rent",
      "bankAccountId": "1830472847398404901",
      "chartOfAccountId": "1830472847398404902",
      "portfolioId": "1830472847398404304",
      "propertyId": "1830472847398404303",
      "unitId": "1830472847398404302",
      "leaseId": "1830472847398404301",
      "tenantId": "1830472847398404096",
      "externalTransactionType": "magicDoor",
      "externalTransactionId": "pi_3Qk2Lm9xBaR",
      "allowedChartOfAccountIds": [
        "1830472847398404902"
      ],
      "metadata": {}
    }
  ],
  "bankAccounts": [
    {
      "id": "1830472847398404901",
      "name": "Riverbend Operating",
      "active": true,
      "accountNumber": "4417",
      "routingNumber": "0021",
      "type": "checking",
      "scheduledSweepDays": [],
      "chartOfAccountIds": [
        "1830472847398404902"
      ],
      "companyAccount": true,
      "creator": {
        "type": "propertyManager",
        "id": "1830472847398404098",
        "deleted": false,
        "source": "direct",
        "propertyManagerId": "1830472847398404098"
      }
    }
  ],
  "chartOfAccounts": [
    {
      "id": "1830472847398404902",
      "number": 4000,
      "type": "income",
      "name": "Rent income",
      "creator": {
        "type": "propertyManager",
        "id": "1830472847398404098",
        "deleted": false,
        "source": "direct",
        "propertyManagerId": "1830472847398404098"
      },
      "isDefault": true
    }
  ],
  "properties": [
    {
      "id": "1830472847398404303",
      "name": "Thistledown Court",
      "displayName": "Thistledown Court",
      "address": {
        "streetAddress1": "4120 Thistledown Lane",
        "city": "Riverbend",
        "state": "OR",
        "zipCode": "97401",
        "country": "USA",
        "isValid": true
      },
      "portfolioId": "1830472847398404304",
      "type": "multiFamily",
      "unitCount": 12,
      "recentRentalApplications": 0,
      "active": true,
      "icons": []
    }
  ],
  "units": [
    {
      "id": "1830472847398404302",
      "name": "3B",
      "address": {
        "streetAddress1": "4120 Thistledown Lane",
        "streetAddress2": "Apt 3B",
        "city": "Riverbend",
        "state": "OR",
        "zipCode": "97401",
        "country": "USA",
        "isValid": true
      },
      "beds": 2,
      "baths": 1,
      "unitSizeSqft": 880,
      "marketRent": 1850,
      "floor": 3,
      "propertyId": "1830472847398404303",
      "portfolioId": "1830472847398404304",
      "active": true,
      "icons": []
    }
  ],
  "leases": [
    {
      "id": "1830472847398404301",
      "portfolioId": "1830472847398404304",
      "propertyId": "1830472847398404303",
      "unitId": "1830472847398404302",
      "start": "2026-03-01",
      "end": "2027-02-28",
      "ended": false,
      "monthToMonth": false,
      "eviction": false,
      "chatId": "1830472847398404700",
      "tenants": [
        {
          "tenantId": "1830472847398404096",
          "moveIn": "2026-03-01"
        }
      ],
      "balance": 0,
      "currentRent": 1850,
      "securityDepositPaid": 1850,
      "securityDepositRequested": 1850,
      "securityDepositDue": 0,
      "lastPaymentDate": "2026-08-01",
      "icons": [],
      "draft": false,
      "status": "lease",
      "expiringStatus": "none",
      "postedBalance": 0
    }
  ],
  "tenants": [
    {
      "id": "1830472847398404096",
      "active": true,
      "email": "marigold.featherstone@example.com",
      "firstName": "Marigold",
      "lastName": "Featherstone",
      "phone": "(555) 012-8834",
      "created": "2026-02-14T10:22:05",
      "updated": "2026-08-17T21:04:11",
      "lastSeen": "2026-08-16T18:41:02",
      "lastPortalInvite": "2026-02-14T10:25:00",
      "portalStatus": "active",
      "chatId": "1830472847398404700",
      "language": "en",
      "currentAddress": {
        "streetAddress1": "4120 Thistledown Lane",
        "streetAddress2": "Apt 3B",
        "city": "Riverbend",
        "state": "OR",
        "zipCode": "97401",
        "country": "USA",
        "isValid": true
      },
      "emergencyContacts": [
        {
          "name": "Cornelius Featherstone",
          "phone": "(555) 012-9910",
          "email": "cornelius.featherstone@example.com",
          "relationship": "Brother"
        }
      ],
      "icons": []
    }
  ],
  "vendors": [],
  "subsidizers": [],
  "owners": []
}