Accounts

Learn about USD accounts and how to manage balances.

Overview

Caibo accounts allow you to open virtual USD accounts powered by Bridge. Each account comes with a unique routing number and account number for receiving ACH and wire transfers.

Supported Currencies

USDMore currencies coming soon

Get Account Balances

get-balances.js
const balances = await caibo.accounts.listBalances();

console.log(balances);
// {
//   balances: [
//     { currency: 'USD', available: 50000, pending: 1000 }
//   ]
// }

Local Bank Details

Get local bank details to receive funds in supported countries:

get-bank-details.js
const bankDetails = await caibo.accounts.getBankDetails('USD');

console.log(bankDetails);
// {
//   currency: 'USD',
//   bankName: 'Caibo Bank',
//   accountNumber: '1234567890',
//   routingNumber: '021000021',
//   accountType: 'checking',
//   address: {
//     line1: '123 Finance Street',
//     city: 'New York',
//     state: 'NY',
//     postalCode: '10001',
//     country: 'US'
//   }
// }

Convert Currency

convert-currency.js
// Get a quote first
const quote = await caibo.conversions.createQuote({
  fromCurrency: 'USD',
  toCurrency: 'COP',
  amount: 10000 // $100.00
});

console.log(quote);
// {
//   id: 'quote_123',
//   fromAmount: 10000,
//   toAmount: 420500,
//   rate: 4205.00,
//   expiresAt: '2026-03-10T10:05:00Z'
// }

// Execute the conversion
const conversion = await caibo.conversions.create({
  quoteId: quote.id
});

Account Statements

get-statement.js
const statement = await caibo.accounts.getStatement({
  currency: 'USD',
  startDate: '2026-03-01',
  endDate: '2026-03-31',
  format: 'pdf' // or 'csv'
});

// Returns a URL to download the statement
console.log(statement.downloadUrl);

Transaction History

list-transactions.js
const transactions = await caibo.accounts.listTransactions({
  currency: 'USD',
  limit: 10,
  startingAfter: 'txn_previous_id'
});

transactions.data.forEach(txn => {
  console.log(`${txn.type}: ${txn.amount} ${txn.currency}`);
});