Create SEPA bank account

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"
}

{
  "code": "VAL",
  "message": "Must provide either (bankHolderFirstName + bankHolderLastName) for individual or businessName for business"
}

{
  "code": "NOT_FOUND",
  "message": "Client does not have a customer ID for provider BRIDGE"
}

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"
}

{
  "code": "VAL",
  "message": "Must provide either (bankHolderFirstName + bankHolderLastName) for individual or businessName for business"
}

{
  "code": "NOT_FOUND",
  "message": "Client does not have a customer ID for provider BRIDGE"
}

Deprecated. This endpoint is no longer available in the public API and is kept for reference only.

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"
}

{
  "code": "VAL",
  "message": "Must provide either (bankHolderFirstName + bankHolderLastName) for individual or businessName for business"
}

{
  "code": "NOT_FOUND",
  "message": "Client does not have a customer ID for provider BRIDGE"
}

Create SPEI bank account Create PIX bank account

Company

Clients (Deprecated)

Individual Clients

Operations

Blockchains

Contracted Products

Create SEPA bank account

Path parameters

Body

Response

​Path parameters

​Body

​Response

Path parameters

Body

Response