Accounts API

Complete API reference for the Accounts endpoint.

GET/v1/accounts/balances

List Balances

Returns all currency balances for your account.

Request

curl
curl https://api.caibopay.com/v1/accounts/balances \
  -H "Authorization: Bearer sk_test_..."

Response

200 OK
{
  "object": "list",
  "data": [
    {
      "currency": "USD",
      "available": 5000000,
      "pending": 100000,
      "reserved": 0
    }
  ]
}

GET/v1/accounts/bank-details/:currency

Get Bank Details

Returns local bank details for receiving funds in a specific currency.

Request

curl
curl https://api.caibopay.com/v1/accounts/bank-details/USD \
  -H "Authorization: Bearer sk_test_..."

Response

200 OK
{
  "currency": "USD",
  "bankName": "Caibo Bank",
  "accountNumber": "1234567890",
  "routingNumber": "021000021",
  "accountType": "checking",
  "accountHolder": "Your Company Inc",
  "address": {
    "line1": "123 Finance Street",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  }
}

GET/v1/accounts/transactions

List Transactions

Query Parameters

currencystring

Filter by currency

limitinteger

Number of results (1-100, default 10)

starting_afterstring

Cursor for pagination

Request

curl
curl "https://api.caibopay.com/v1/accounts/transactions?currency=USD&limit=20" \
  -H "Authorization: Bearer sk_test_..."