Skip to main content
POST
/
management
/
clients
/
{clientId}
/
banks
/
co-bank-transfer
curl -X POST "https://api.cryptomate.me/management/clients/client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/banks/co-bank-transfer" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_name": "Bancolombia",
    "account_alias": "Cuenta COP principal",
    "bank_holder_first_name": "María",
    "bank_holder_last_name": "López",
    "account_number": "12345678901234",
    "bank_code": "1007",
    "co_account_type": "savings",
    "document_type": "cc",
    "document_number": "1234567890",
    "phone_number": "+573001234567",
    "address": {
      "street_line_1": "Carrera 7 # 71-21",
      "city": "Bogotá",
      "postal_code": "110231",
      "state": "COL-DC",
      "country": "COL"
    }
  }'

{
  "id": "ba_co_abc123",
  "company_id": "comp_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
  "client_id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "bank_name": "Bancolombia",
  "bank_holder_name": "María López",
  "account_alias": "Cuenta COP principal",
  "type": "CO_BANK_TRANSFER",
  "currency": "COP",
  "bank_code": "1007",
  "co_account_type": "savings",
  "document_type": "cc",
  "document_number": "1234567890",
  "phone_number": "+573001234567"
}

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 CO Bank Transfer bank account (COP) 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
Colombian bank account number.
​
bank_code
string
Colombian bank code. See List Colombian bank codes for accepted values.
​
co_account_type
string
Colombian account sub-type. One of checking, savings, electronic_deposit. See List CO account types.
​
document_type
string
Colombian document type identifier. Common values: cc (Cédula de Ciudadanía), ce (Cédula de Extranjería), nit (business tax ID), rut (worker registration).
​
document_number
string
Document number of the account holder.
​
phone_number
string
Phone number of the account holder in E.164 format (e.g., +573001234567).
​
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. CO Bank Transfer accounts expose bank_code, co_account_type, document_type, document_number, phone_number, and business_name when applicable. The type is CO_BANK_TRANSFER and the currency is COP. 
curl -X POST "https://api.cryptomate.me/management/clients/client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/banks/co-bank-transfer" \
  -H "x-api-key: $CRYPTOMATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_name": "Bancolombia",
    "account_alias": "Cuenta COP principal",
    "bank_holder_first_name": "María",
    "bank_holder_last_name": "López",
    "account_number": "12345678901234",
    "bank_code": "1007",
    "co_account_type": "savings",
    "document_type": "cc",
    "document_number": "1234567890",
    "phone_number": "+573001234567",
    "address": {
      "street_line_1": "Carrera 7 # 71-21",
      "city": "Bogotá",
      "postal_code": "110231",
      "state": "COL-DC",
      "country": "COL"
    }
  }'

{
  "id": "ba_co_abc123",
  "company_id": "comp_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23",
  "client_id": "client_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "bank_name": "Bancolombia",
  "bank_holder_name": "María López",
  "account_alias": "Cuenta COP principal",
  "type": "CO_BANK_TRANSFER",
  "currency": "COP",
  "bank_code": "1007",
  "co_account_type": "savings",
  "document_type": "cc",
  "document_number": "1234567890",
  "phone_number": "+573001234567"
}