Skip to main content
POST
/
management
/
clients
/
{clientId}
/
banks
/
bre-b
curl -X POST "https://api.cryptomate.me/management/clients/client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/banks/bre-b" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_name": "Banco de Bogotá",
    "account_alias": "Mi Bre-B",
    "bank_holder_name": "María López",
    "bre_b_key": "1234567890123456",
    "address": {
      "street_line_1": "Carrera 7 # 71-21",
      "city": "Bogotá",
      "postal_code": "110231",
      "state": "COL-DC",
      "country": "COL"
    }
  }'

{
  "id": "ba_breb_abc123",
  "company_id": "comp_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
  "client_id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "bank_name": "Banco de Bogotá",
  "bank_holder_name": "María López",
  "account_alias": "Mi Bre-B",
  "type": "BRE_B",
  "currency": "COP",
  "bre_b_key": "1234567890123456"
}

Documentation Index

Fetch the complete documentation index at: https://docs.cryptomate.me/llms.txt

Use this file to discover all available pages before exploring further.

Creates a new Colombian Bre-B bank account (COP) for the specified client. Bre-B uses a single key (bre_b_key) as the destination identifier and does not distinguish between individual and business clients. Requires an API key with access level 3 or higher. Virtual account numbers are not accepted as Bre-B keys.

​
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_name
string
Account holder full name (used for both individual and business clients).
​
bre_b_key
string
Bre-B key. The destination identifier the customer’s bank app will send funds to.
​
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., COL-DC for Bogotá D.C.).

​
Response

See Create US bank account for the shared field list. Bre-B accounts expose bre_b_key. The type is BRE_B and the currency is COP. 
curl -X POST "https://api.cryptomate.me/management/clients/client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/banks/bre-b" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_name": "Banco de Bogotá",
    "account_alias": "Mi Bre-B",
    "bank_holder_name": "María López",
    "bre_b_key": "1234567890123456",
    "address": {
      "street_line_1": "Carrera 7 # 71-21",
      "city": "Bogotá",
      "postal_code": "110231",
      "state": "COL-DC",
      "country": "COL"
    }
  }'

{
  "id": "ba_breb_abc123",
  "company_id": "comp_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
  "client_id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "bank_name": "Banco de Bogotá",
  "bank_holder_name": "María López",
  "account_alias": "Mi Bre-B",
  "type": "BRE_B",
  "currency": "COP",
  "bre_b_key": "1234567890123456"
}