Return Financial Accounts

The GET /api/financialAccounts/v2 endpoint retrieves all financial accounts linked to the authenticated user's profile. Each account record includes identifying details such as account number, routing number, current and available balances, account type, and enabled features. The response also provides aggregate totals across all accounts, making it easy to display a consolidated financial overview in a single request.

Endpoint

GET /api/financialAccounts/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 render a customer's complete account dashboard, showing all active financial accounts with their current balances and statuses. It is the primary call for account management screens where users need to select a source or destination account for transfers, card funding, or rewards redemption. Because it returns aggregate totals alongside individual account data, it is well-suited for summary views and reporting features.

Response

200 OK

Top-level object

financialAccounts[] object

Amount object (availableCash, cash)

totals object

{
  "financialAccounts": [
    {
      "financialAccountId": "fa_01HXYZ1234ABCDEF5678",
      "name": "Business Checking",
      "accountNumber": "XXXXXXXXXX",
      "routingNumber": "021000021",
      "status": "Active",
      "availableCash": {
        "value": 250000,
        "currencyCode": "USD"
      },
      "cash": {
        "value": 275000,
        "currencyCode": "USD"
      },
      "created": "2024-03-15T10:22:00Z",
      "isPrimary": true,
      "cashIn": 1000000,
      "cashOut": 725000,
      "accountType": "Checking",
      "partnerName": "Netevia Partner",
      "features": [
        "Transfer",
        "OpenPaymentCard",
        "RedeemsPoints"
      ],
      "isLockAccount": false,
      "isProductFundingAccount": false
    },
    {
      "financialAccountId": "fa_01HXYZ5678GHIJKL9012",
      "name": "Savings Reserve",
      "accountNumber": "XXXXXXXXXX",
      "routingNumber": "021000021",
      "status": "Active",
      "availableCash": {
        "value": 500000,
        "currencyCode": "USD"
      },
      "cash": {
        "value": 500000,
        "currencyCode": "USD"
      },
      "created": "2024-04-01T08:00:00Z",
      "isPrimary": false,
      "cashIn": 600000,
      "cashOut": 100000,
      "accountType": "Savings",
      "partnerName": "Netevia Partner",
      "features": [
        "Transfer"
      ],
      "isLockAccount": false,
      "isProductFundingAccount": false
    }
  ],
  "totals": {
    "cashIn": 1600000,
    "cashOut": 825000,
    "cash": 775000,
    "availableCash": 750000
  }
}

Error Codes

Common Mistakes

• Treating value in availableCash and cash as dollars — these are in minor currency units (cents). Divide by 100 to display a dollar amount (e.g., 250000 = $2,500.00).
• Assuming the response includes external accounts linked via Finicity or Plaid — this endpoint returns only Netevia-hosted financial accounts.
• Not handling the features array — some account operations (e.g., opening a payment card or redeeming points) are only available if the corresponding feature is present in this list.
• Expecting more than 5 accounts by default — each customer is limited to 5 active financial accounts unless the limit has been extended by the partner.

Related Endpoints

• POST /api/financialAccounts/v2 — Create a new financial account for a customer
• GET /api/financialAccounts/v2/{financialAccountId} — Retrieve details for a specific financial account
• POST /api/transfers/v2 — Initiate a transfer between financial accounts
• GET /api/transactions/v2 — Retrieve transaction history for a financial account

Example

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