Get Transfer Amount Limits

This endpoint retrieves the transfer amount limits set for the authenticated user's account. It returns the maximum amounts allowed for ACH outbound transfers and internal transfers, enabling partners and users to enforce or display limit information before initiating a transfer.

Endpoint

GET /settings/transferLimits

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 before initiating a transfer to verify that the intended amount falls within the allowed limits for the account. This is especially useful in partner UIs to pre-validate user input, display limit guidance, or gate transfer submission logic based on account-level configurations.

Response

200 OK

{
  "achOutTransferAmountLimit": 10000,
  "internalTransferAmountLimit": 25000
}

Error Codes

Common Mistakes

• Calling this endpoint without a valid Bearer token will result in a 401 error; always ensure the token has been obtained and has not expired before making the request.
• Assuming a non-null value is always returned — both achOutTransferAmountLimit and internalTransferAmountLimit are nullable and may be null if no limit has been explicitly set for the account.
• Confusing achOutTransferAmountLimit (for external ACH transfers) with internalTransferAmountLimit (for transfers between accounts within the platform); apply the correct limit check depending on the transfer type being initiated.

Related Endpoints

• POST /transfers/ach — Initiate an ACH outbound transfer subject to the ACH limit
• POST /transfers/internal — Initiate an internal transfer subject to the internal transfer limit
• GET /settings — Retrieve general account settings

Example

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