Get Default Financial Account for A2A Transfers

This endpoint retrieves the default financial account used for Account-to-Account (A2A) transfers. It returns the identifier of the financial account currently designated as the default source or destination for A2A transfer operations. If no default has been set, a 404 response is returned.

Endpoint

GET /settings/defaultTransfersFinAccount

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 determine which financial account is currently set as the default for A2A transfers before initiating a transfer. This is useful for pre-populating transfer forms, validating user preferences, or confirming the active default before allowing the user to proceed with an account-to-account transfer. Both personal and business customers can use this endpoint to inspect their current transfer default setting.

Response

200 OK

{
  "finAccountId": "facc_3f7a2b1c9d4e6f08"
}

404 Not Found

Returned when no default financial account has been configured for A2A transfers for the authenticated user.

{}

Error Codes

Common Mistakes

• Calling this endpoint without a valid Bearer token results in a 401 error; ensure the token is obtained and refreshed before making the request.
• Assuming a 404 means the account is missing — it specifically means no default transfer account has been configured yet; prompt the user to set one via the corresponding PUT/POST settings endpoint.
• Not handling a null value for finAccountId in the 200 response; the field is nullable and must be checked before use.

Related Endpoints

• PUT /settings/defaultTransfersFinAccount — Set or update the default financial account for A2A transfers
• GET /finAccounts — List all financial accounts available to the authenticated user
• POST /transfers — Initiate an Account-to-Account transfer

Example

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