Bank Accounts

Bank accounts are a fundamental component of the Coba API, enabling you to manage and interact with financial accounts programmatically. On this page, you’ll find everything you need to create, retrieve, and manage bank accounts through our API.

The bank account model

The bank account model contains all the information about a bank account created through the Coba API. It includes details such as the account number, account holder name, bank name, currency, and status.

Each bank account is uniquely identified by a token, which is used for referencing the account in client-side or follow-up operations.

POST/crypto/bank_accounts

Create a bank account

This endpoint allows you to create a new bank account.

Required attributes

Name
user_id
Type
string
Description
The unique identifier of the user who owns the bank account.
Name
country
Type
string
Description
The country where the bank account is located.
Name
fiat
Type
string
Description
The currency of the bank account
One of: MXN, USD
Name
bank_name
Type
string
Description
The name of the bank where the account is held.
Name
account_holder_name
Type
string
Description
The name of the account holder.
Name
account_number
Type
string
Description
The account number. Only for US bank accounts
Name
routing_number
Type
string
Description
The routing number for the account. Only for US bank accounts
Name
notes
Type
string
Description
Any additional notes about the account.
Name
CCI
Type
string
Description
The CCI (Clave de Cuenta Interbancaria) for the account.
Name
CLABE
Type
string
Description
The CLABE (Clave Bancaria Estandarizada) for the account.
Name
email
Type
string
Description
Only necessary if the bank account is NVIO bank account for Bitso transfer.
Name
address
Type
object
Description
Only required for US bank accounts. Address of the bank account.
Name
street1
Type
string
Description
The first line of the street address.
Name
street2
Type
string
Description
The second line of the street address (optional).
Name
city
Type
string
Description
The city of the address.
Name
state
Type
string
Description
The state or province of the address.
Name
postal_code
Type
string
Description
The postal code of the address.
Name
country
Type
string
Description
The country of the address.

Request

POST

/crypto/bank_accounts

curl -X POST https://sandbox.api.coba.ai/metal/crypto/bank_accounts \
  -H "Authorization: Bearer {token}" \
  -H "X-Coba-Metal-API-Key: {client_api_key}" \
  -d '{
    "bank_account": {
        "user_id": "68811830bb6e5d659501e1e8",
        "country": "MX",
        "fiat": "MXN",
        "bank_name": "Banco Azteca",
        "account_holder_name": "John Doe",
        "notes": "My primary bank account",
        "CLABE": "123456789012345678901"
    }
}'

Successful Response

  {
    "id": "6859b5bd07ef6fefaeaf5604",
    "user_id": "68408e32b5507b00351ac587",
    "created_at": "2025-06-23T20:14:53.850Z",
    "bank_name": "Banamex",
    "country": "MX",
    "account_holder_name": "John Wick",
    "fiat": "MXN",
    "account_number": null,
    "clabe": "601180400024542654",
    "cci": null
  }

GET/crypto/bank_accounts/{id}

Get a bank account

This endpoint allows you to retrieve the details of a specific bank account.

Request

GET

/crypto/bank_accounts/{id}

curl -X GET https://sandbox.api.coba.ai/metal/crypto/bank_accounts/{id} \
  -H "Authorization: Bearer {token}" \
  -H "X-Coba-Metal-API-Key: {client_api_key}"
}'

Successful Response

  {
    "id": "6859b5bd07ef6fefaeaf5604",
    "user_id": "68408e32b5507b00351ac587",
    "created_at": "2025-06-23T20:14:53.850Z",
    "bank_name": "Banamex",
    "country": "MX",
    "account_holder_name": "John Wick",
    "fiat": "MXN",
    "account_number": null,
    "clabe": "601180400024542654",
    "cci": null
  }