Vendor payment accounts

List a vendor's payment accounts

Returns every payment account on file for one vendor — 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/vendors/{vendorId}/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

vendorIdstringrequired

The vendor whose payment accounts these are. A Snowflake id sent as a decimal string.

example: 1822910038475120640

Response

200 · The vendor's payment accounts.

paymentAccountsPaymentAccount[]

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

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

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

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/vendors/1822910038475120640/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"
      }
    }
  ]
}