Tenant payment accounts

List a tenant's payment accounts

Returns every payment account on file for one tenant — the bank accounts and cards MagicDoor can move money to or from on their behalf. Full account, routing and card numbers are never returned; only the last four digits are.

GET

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

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 whose payment accounts these are. A Snowflake id sent as a decimal string.

example: 1810472847398404096

Response

200 · The tenant's payment accounts.

paymentAccountsPaymentAccount[]

The accounts on file for this tenant. Empty when there are none.

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

404 · No tenant with that id exists for the caller's company.

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/tenants/1810472847398404096/payment-accounts' \
  --header 'Authorization: Bearer <token>'

Response

{
  "paymentAccounts": [
    {
      "id": "1823910038475120640",
      "name": "Operating — checking",
      "accountMask": "4242",
      "accountProvider": "plaid",
      "mapped": true,
      "plaid": {
        "plaidAccountNumber": "4242",
        "plaidAccountName": "Plaid Checking",
        "plaidAccountOfficialName": "Plaid Gold Standard 0% Interest Checking",
        "plaidAccountType": "depository"
      }
    }
  ]
}