Bank Account EUR

Introduction

EUR Bank Account is used as the destination bank account when you off-ramp to EUR fiat through SEPA transfers. In order to receive money into your EUR bank account, you need to register it here first and then reference it in tickets that send EUR out to a bank.

warning

On this rail, use SEPA only. A EUR beneficiary registered here is paid over SEPA; if you send funds over SWIFT to it instead, we have no visibility of the payment and cannot process or track it. To pay a EUR account over the SWIFT network, register a SWIFT beneficiary instead — see Beneficiary Bank Accounts > Bank Guide SWIFT.

info

All the endpoints here are applicable to subAccounts, just pass the subAccountId field followed by the subaccount id as the request parameter.

Register a EUR Beneficiary Account

Let's take a look at the data needed to create your EUR bank account:

HTTP POST Request

Endpoint:

https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/eur/

cURL Example:

curl -X POST "https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/eur/" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-d '{
  "alias": "Payroll Account",
  "description": "Main EUR beneficiary account",
  "iban": "FR186323717830259KW1JGZSE48",
  "bic": "COBADEFFXXX",
  "country": "FRA",
  "bankBeneficiaryName": "ACME Corp dGmbH"
}'

Fields

Field	Type	Required	Description
alias	string	Yes (1–100 chars)	Custom name to identify the account.
description	string	No (max 255 chars)	Brief description of the bank account.
iban	string	Yes	International Bank Account Number (IBAN).
bic	string	No	BIC/SWIFT code — used to route the SEPA transfer. For a payout over the SWIFT network, use a SWIFT beneficiary instead
country	string	Yes	ISO country code (e.g., "FRA", "DEU", "ITA").
bankBeneficiaryName	string	Yes	Full name of the account holder.

Sample JSON Body

{
  "alias": "Payroll Account",
  "description": "Main EUR beneficiary account",
  "iban": "FR186323717830259KW1JGZSE48",
  "bic": "COBADEFFXXX",
  "country": "FRA",
  "bankBeneficiaryName": "ACME Corp dGmbH"
}

JSON Response

{
  "id": "00000000-0000-0000-0000-000000000000"
}

List all EUR beneficiaries bank accounts

To get all the EUR bank accounts, let's use the endpoint below, with filter fields:

info

All the endpoints here are applicable to subAccounts, just pass the subAccountId field followed by the subaccount id as the request parameter.

HTTP GET Request

https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/eur/

Filter Fields

Field	Type	Description
subAccountId	string	The ID of a sub-account. If provided, data will be fetched for the sub-account; leave empty for main account.
createdAfter	int64	Unix epoch timestamp in milliseconds (UTC) — e.g. 1700000000000. Returns results created on or after this instant (created_at >= createdAfter).
createdBefore	int64	Unix epoch timestamp in milliseconds (UTC) — e.g. 1800000000000. Returns results created strictly before this instant (created_at < createdBefore).
cursor	string	Cursor for pagination. Pass the value from the previous response to retrieve the next set of results.
alias	string	Filters results to include only those with the specified alias.

Timestamp format

createdAfter / createdBefore are Unix epoch timestamps in milliseconds, UTC (13 digits for current dates, e.g. 1700000000000) — not seconds. If you have a value in seconds, multiply it by 1000. The lower bound is inclusive and the upper bound is exclusive, and the returned createdAt is an RFC3339 UTC string ending in Z. Convert local date boundaries to UTC before computing the epoch.

cUrl Example:

curl -X GET "https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/eur/?subAccountId=&createdAfter=1700000000000&createdBefore=1800000000000&cursor=NEXT_CURSOR&alias=Payroll Account" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

JSON Response

{
  "bankAccounts": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "userId": "11111111-1111-1111-1111-111111111111",
      "alias": "Payroll Account",
      "description": "Main EUR beneficiary account",
      "iban": "FR186323717830259KW1JGZSE48",
      "bic": "COBADEFFXXX",
      "country": "FRA",
      "bankBeneficiaryName": "ACME Corp dGmbH",
      "createdAt": "2025-02-20T15:13:08.320462Z"
    }
  ],
  "cursor": "MzItMTc0MDA2NDM4ODMyMA..."
}

Get EUR beneficiary bank account by ID

To retrieve the details of a specific EUR bank account:

info

All the endpoints here are applicable to subAccounts, just pass the subAccountId field followed by the subaccount id as the request parameter.

HTTP GET Request

https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/eur/00000000-0000-0000-0000-000000000000

cUrl Example

curl -X GET "https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/eur/00000000-0000-0000-000000000000" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

JSON Response

{
  "bankAccount": {
    "id": "00000000-0000-0000-0000-000000000000",
    "userId": "11111111-1111-1111-1111-111111111111",
    "alias": "Payroll Account",
    "description": "Main EUR beneficiary account",
    "iban": "FR186323717830259KW1JGZSE48",
    "bic": "COBADEFFXXX",
    "country": "FRA",
    "bankBeneficiaryName": "ACME Corp dGmbH",
    "createdAt": "2025-02-20T15:13:08.320462Z"
  }
}

Delete EUR beneficiary bank Account

To delete a specific EUR bank account:

info

All the endpoints here are applicable to subAccounts, just pass the subAccountId field followed by the subaccount id as the request parameter.

HTTP DELETE Request

https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/eur/00000000-0000-0000-0000-000000000000

cUrl Example

curl -X DELETE "https://api.sandbox.avenia.io:10952/v2/account/beneficiaries/bank-accounts/eur/00000000-0000-0000-0000-000000000000" \
-H "Authorization: Bearer eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Your EUR bank account has been deleted!

Conclusion

In this section, you have learned how to manage EUR bank accounts within the Avenia API system.

warning

Important: A beneficiary registered here is always paid over SEPA, so make sure the receiving bank supports SEPA. EUR over the SWIFT network is a different rail with its own beneficiary — see Beneficiary Bank Accounts > Bank Guide SWIFT.

What we've covered:

• ✅ Creating a EUR Bank Account – Register a new EUR bank account for SEPA transfers.
• ✅ Fetching All EUR Bank Accounts – Retrieve all your EUR bank accounts.
• ✅ Fetching a Specific EUR Bank Account by ID – Retrieve details by UUID.
• ✅ Deleting a EUR Bank Account – Permanently remove a EUR bank account.

By following these steps, you now have full control over your EUR bank accounts within Avenia API. You can now use the returned beneficiaryEurBankAccountId when creating output tickets that off-ramp EUR to a bank via SEPA network.