Get Financial Account Numbers

Deprecated: This endpoint is deprecated and was scheduled for removal as of March 1, 2022. It should not be used in new integrations. Use the current financial accounts endpoints instead.

This endpoint returns an array of financial accounts associated with the authenticated session, including each account's direct deposit details such as account number and routing number. It is a GET request with no request body or query parameters required.

Endpoint

GET /api/financialAccounts/number

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

This endpoint was intended to retrieve direct deposit banking details (account number, routing number) for financial accounts linked to the authenticated partner or customer. Because it is deprecated, partners needing account number information should migrate to the current financial accounts API. Do not build new integrations against this endpoint.

Response

200 OK

Returns an array of financialAccountDepositModel objects.

financialAccountDepositModel

node (directDeposit)

node.restrictedDetails (directDepositRestrictedDetails)

[
  {
    "id": "fa_abc123def456",
    "name": "Primary Checking",
    "created": "2023-08-15T10:30:00Z",
    "node": {
      "id": "dd_xyz789",
      "restrictedDetails": {
        "typename": "CHECKING",
        "number": "XXXXXXXXXX",
        "routingNumber": "021000021"
      }
    }
  },
  {
    "id": "fa_def456ghi789",
    "name": "Business Savings",
    "created": "2023-09-01T08:00:00Z",
    "node": {
      "id": "dd_uvw321",
      "restrictedDetails": {
        "typename": "SAVINGS",
        "number": "XXXXXXXXXX",
        "routingNumber": "021000021"
      }
    }
  }
]

Error Codes

Common Mistakes

• Using this endpoint in new integrations — it is deprecated; migrate to the current financial accounts API.
• Logging or exposing the number (account number) or routingNumber fields — these are restricted details and must be handled securely and never stored in plain text or logs.
• Assuming the response includes all account types; this endpoint only surfaces accounts with direct deposit details attached.

Related Endpoints

• GET /api/financialAccounts — Retrieve all financial accounts for a customer (current, non-deprecated endpoint)
• GET /api/financialAccounts/{id} — Retrieve a specific financial account by ID
• POST /api/auth/v2 — Obtain a Bearer token for authentication

Example

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