Skip to main content
POST
/
management
/
clients
/
{clientId}
/
banks
/
sepa
curl -X POST "https://api.cryptomate.me/management/clients/client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/banks/sepa" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_name": "Deutsche Bank",
    "account_alias": "Primary SEPA Account",
    "bank_holder_first_name": "Hans",
    "bank_holder_last_name": "Mueller",
    "account_number": "DE89370400440532013000",
    "bic": "DEUTDEFF",
    "country": "DEU",
    "address": {
      "streetLine1": "Friedrichstrasse 100",
      "city": "Berlin",
      "postal_code": "10117",
      "state": "DEU-BE",
      "country": "DEU"
    }
  }'
{
  "id": "ba_ghi789",
  "client_id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "bank_name": "Deutsche Bank",
  "type": "SEPA",
  "currency": "EUR",
  "iban": "DE89370400440532013000",
  "bic": "DEUTDEFF"
}
Creates a new European SEPA bank account for the specified client. Supports both individual and business clients via mutually exclusive holder name fields. Requires an API key with access level 3 or higher.

Path parameters

clientId
string
required
Unique identifier of the client.

Body

bank_name
string
Name of the bank.
account_alias
string
User-friendly alias for the account.
bank_holder_first_name
string
Account holder’s first name. Required for individual clients; mutually exclusive with business_name.
bank_holder_last_name
string
Account holder’s last name. Required for individual clients; mutually exclusive with business_name.
business_name
string
Business name. Required for business clients; mutually exclusive with bank_holder_first_name + bank_holder_last_name.
account_number
string
IBAN (International Bank Account Number).
bic
string
BIC/SWIFT code.
country
string
ISO 3166-1 alpha-3 country code (e.g., DEU, FRA, ESP).
address
object
Account holder’s address with street_line_1, street_line_2, city, postal_code, state, country.state uses ISO 3166-2 codes that identify country subdivisions in the format {COUNTRY}-{SUBDIVISION} (e.g., USA-CA for California).

Response

See Create US bank account for the full field list. SEPA accounts expose iban and bic.
curl -X POST "https://api.cryptomate.me/management/clients/client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/banks/sepa" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_name": "Deutsche Bank",
    "account_alias": "Primary SEPA Account",
    "bank_holder_first_name": "Hans",
    "bank_holder_last_name": "Mueller",
    "account_number": "DE89370400440532013000",
    "bic": "DEUTDEFF",
    "country": "DEU",
    "address": {
      "streetLine1": "Friedrichstrasse 100",
      "city": "Berlin",
      "postal_code": "10117",
      "state": "DEU-BE",
      "country": "DEU"
    }
  }'
{
  "id": "ba_ghi789",
  "client_id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "bank_name": "Deutsche Bank",
  "type": "SEPA",
  "currency": "EUR",
  "iban": "DE89370400440532013000",
  "bic": "DEUTDEFF"
}