Get My Open Financial Accounts
Deprecated: This endpoint is marked as deprecated. Use the current financial accounts endpoint for new integrations.
The GET /api/financialAccounts/me endpoint retrieves all open and active financial accounts linked to the authenticated user's profile. It returns key account details such as account type, balance, and account identifiers, enabling users to view and manage their current financial accounts in a single call.
Endpoint
GET /api/financialAccounts/me
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 a quick snapshot of all open financial accounts tied to the currently authenticated user. It is suitable for displaying account overviews on dashboards, verifying available balances before initiating transfers, or supporting account-selection flows during payment and transfer operations. Note that this endpoint is deprecated; new integrations should use the current financial accounts listing endpoint.
Response
200 OK
Returns an array of strings representing the open financial accounts associated with the authenticated user's profile.
| Field | Type | Description |
|---|---|---|
| (array items) | string | Identifiers or representations of each open financial account linked to the user's profile |
[
"XXXXXXXXXX",
"XXXXXXXXXX"
]Error Codes
| Code | When it happens |
|---|---|
| 401 | Token missing, expired, or invalid |
| 403 | Insufficient permissions to access financial accounts |
| 404 | No open financial accounts found for the authenticated user |
| 500 | Internal server error |
Common Mistakes
- This endpoint is deprecated — avoid using it in new integrations; migrate to the current financial accounts endpoint.
- Sending requests with an expired token (lifetime is 10 minutes) will result in a 401 error; refresh the token via
POST /api/auth/refreshbefore retrying. - The
partnerIdmust be included where required by the platform; omitting it may cause authorization failures. - Do not assume the returned array contains full account objects — the schema defines items as strings; parse and map them using additional account detail endpoints as needed.
Related Endpoints
GET /api/financialAccounts— Retrieve financial accounts with full detail for the partner's customersPOST /api/auth/v2— Obtain a Bearer token for authenticationPOST /api/auth/refresh— Refresh an existing Bearer token
Example
curl -X GET https://api.banking.netevia.dev/api/financialAccounts/me \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"