Check Financial Accounts Limit

The Check Financial Accounts Limit endpoint returns the financial account limit applicable to the authenticated customer. This scalar integer value represents the maximum number of active financial accounts the customer is permitted to hold. Partners can use this value to enforce account creation rules before attempting to open new accounts on behalf of a customer.

Endpoint

GET /api/financialAccounts/financialAccountsLimit

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

Call this endpoint before creating a new financial account to verify whether the customer has reached their account limit. By default, Netevia allows up to 5 active financial accounts per customer; this limit can be extended upon request. Checking the limit in advance prevents unnecessary 400-series errors during account creation flows.

Response

200 OK

{
  "value": 5
}

Error Codes

Common Mistakes

• Confusing this endpoint's response with a count of existing accounts — it returns the allowed limit, not the current number of accounts the customer has.
• Not refreshing the Bearer token before calling this endpoint; tokens expire after 10 minutes and will result in a 401 error.

Related Endpoints

• GET /api/financialAccounts — List all financial accounts for the authenticated customer
• POST /api/financialAccounts — Create a new financial account
• GET /api/financialAccounts/{financialAccountId} — Retrieve details for a specific financial account

Example

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