Get the List of External Bank Accounts V2

This endpoint returns an array of external bank accounts associated with the authenticated customer. External accounts are linked via providers such as Finicity or Plaid and must pass underwriting verification before they can be used for ACH transfers. Each record includes account identifiers, balance information, and the current account status.

Deprecated: This endpoint is deprecated. New integrations should use the current version of the external bank accounts listing endpoint.

Endpoint

GET /api/fundsMovement/externalBankAccounts/v2

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint to display a customer's linked external bank accounts before initiating an ACH transfer or pull payment. It is useful when building account-selection UIs or verifying that an external account is in an active, usable state prior to funds movement. Note that this version is deprecated and should not be used for new integrations.

Response

200 OK

Returns an array of external financial account objects.

externalfinancialaccount object

externalBankAccountDetails object

balanceInfo object

[
  {
    "typename": "ExternalFinancialAccount",
    "externalBankAccountType": 0,
    "id": "efa_0123456789abcdef",
    "name": "Chase Checking",
    "externalBankAccountDetails": {
      "last4": "6789",
      "type": "CHECKING",
      "routingNumber": "021000021",
      "createdAt": "2025-03-15T10:30:00Z",
      "updatedAt": "2025-06-01T08:00:00Z",
      "accountNumber": "XXXXXXXXXX"
    },
    "provider": "Plaid",
    "createdAt": "2025-03-15T10:30:00Z",
    "accountStatus": "ACTIVE",
    "updatedAt": "2025-06-01T08:00:00Z",
    "bankName": "Chase Bank",
    "owners": null,
    "balanceInfo": {
      "date": "2026-06-08T07:00:00Z",
      "value": 4250.00,
      "currency": "USD"
    }
  }
]

Error Codes

Common Mistakes

• Calling this deprecated endpoint for new integrations instead of using the current external bank accounts endpoint.
• Assuming accountStatus: ACTIVE means the account is ready for ACH transfers — always confirm underwriting verification has completed before initiating funds movement.
• Displaying the full accountNumber value from externalBankAccountDetails in a UI — use last4 for display purposes only.
• Not handling a null or empty array response, which occurs when a customer has no linked external accounts.

Related Endpoints

• POST /api/fundsMovement/externalBankAccounts — Link a new external bank account via Finicity or Plaid
• DELETE /api/fundsMovement/externalBankAccounts/{accountId} — Remove a linked external bank account
• POST /api/fundsMovement/ach — Initiate an ACH transfer using a linked external account

Example

curl -X GET https://api.banking.netevia.dev/api/fundsMovement/externalBankAccounts/v2 \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"