Get Only My Open Financial Accounts

This endpoint returns all open financial accounts associated with the currently authenticated customer. The response provides an array of account identifiers, allowing partners and customers to enumerate their active accounts without retrieving closed or inactive ones.

Endpoint

GET /api/financialAccounts/me/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 when you need to list only the currently open financial accounts for the authenticated customer, such as when populating an account selection dropdown, verifying which accounts are available for transfers, or checking how many active accounts the customer holds before creating a new one. Netevia allows up to 5 active financial accounts per customer by default.

Response

200 OK

{
  "values": [
    "XXXXXXXXXX",
    "XXXXXXXXXX"
  ]
}

Error Codes

Common Mistakes

• Calling this endpoint without a valid Bearer token will result in a 401 error; ensure the token has not expired (lifetime is 10 minutes) and refresh via /api/auth/refresh if needed.
• The values field may be null rather than an empty array when the customer has no open accounts; always perform a null check before iterating.
• This endpoint returns identifiers for open accounts only; closed or suspended accounts are excluded from the response.

Related Endpoints

• POST /api/financialAccounts — Create a new financial account for a customer
• GET /api/financialAccounts/{financialAccountId} — Retrieve details for a specific financial account
• GET /api/financialAccounts/me — Get all financial accounts (including non-open) for the authenticated customer

Example

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