Get External Accounts

The Get External Accounts endpoint retrieves a comprehensive list of external accounts linked to a specific customer profile. Each returned account includes details such as account type, balance information, account status, and the provider through which the account was connected. This endpoint supports financial oversight by allowing partners to surface all externally linked accounts for a given customer in a single call.

Endpoint

GET /netevia/externalAccounts/{profileId}

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 when you need to display or audit all external financial accounts a customer has linked to their profile, such as accounts connected via Finicity or Plaid. It is commonly called during account management flows, before initiating ACH transfers, or when presenting a consolidated view of a customer's external banking relationships.

Path Parameters

Response

200 OK

Returns an array of external financial account objects.

externalfinancialaccount object

externalBankAccountDetails sub-fields

balanceInfo sub-fields

[
  {
    "typename": "ExternalBankAccount",
    "externalBankAccountType": 0,
    "id": "ext-acct-00112233",
    "name": "My Checking Account",
    "externalBankAccountDetails": {
      "last4": "4321",
      "type": "checking",
      "routingNumber": "021000021",
      "createdAt": "2025-03-10T08:00:00Z",
      "updatedAt": "2025-03-10T08:00:00Z",
      "accountNumber": "XXXXXXXXXX"
    },
    "provider": "Plaid",
    "createdAt": "2025-03-10T08:00:00Z",
    "accountStatus": "active",
    "updatedAt": "2026-01-15T12:30:00Z",
    "bankName": "Chase Bank",
    "owners": null,
    "balanceInfo": {
      "date": "2026-06-08T00:00:00Z",
      "value": 1540.75,
      "currency": "USD"
    }
  }
]

Error Codes

Common Mistakes

• Passing a non-integer or string value for profileId — the field must be a valid int32.
• Expecting a single object in the response — the endpoint always returns an array, even if only one account is linked.
• Assuming accountNumber in externalBankAccountDetails is always populated — some providers return only last4 and omit the full account number.
• Not refreshing the Bearer token before calling this endpoint — tokens expire after 10 minutes and will return a 401 error.

Related Endpoints

• POST /netevia/externalAccounts — Link a new external account to a customer profile via Finicity or Plaid.
• DELETE /netevia/externalAccounts/{profileId}/{accountId} — Remove a linked external account from a customer profile.
• GET /netevia/profile/{profileId} — Retrieve the customer profile associated with the given profile ID.

Example

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