CorebanqCorebanq Developer Docs
Accountsv2

Get unified accounts balance (fiat + crypto)

Retrieves consolidated balance information for both traditional bank accounts and cryptocurrency assets. Supports advanced filtering, currency conversion, and optional detailed breakdown. Includes support for major stablecoins and crypto assets from various issuers including Circle (USDC, EURC), Banking Circle (EURI), Crypto.com (USD1), Fiat Republic (ENEUR), Membrane Finance (EURe, eUSD), Quantoz Payments (EURD, EURQ, USDQ), Schuman Financial (EURØP), SG Forge (EURCV), StablR (EURR, USDR), and Stable Mint (EURSM).

GET/v2/accounts/balance

Query Parameters

customer_id*string

Customer ID for balance inquiry

currency*string

Target currency for balance display and conversion (e.g., EUR, USD)

search.is_crypto?boolean

Filter by account type: true for crypto assets only, false for fiat accounts only

search.currency?string

Filter by specific account currency (e.g., EUR, USDC, EURC)

search.active?boolean

Filter by account status: true for active accounts only

search.status?string

Filter by account status (e.g., active, inactive, suspended)

search.balance.gt?string

Filter accounts with balance greater than specified amount (in account's native currency)

search.balance.gte?string

Filter accounts with balance greater than or equal to specified amount

search.balance.lt?string

Filter accounts with balance less than specified amount

search.balance.lte?string

Filter accounts with balance less than or equal to specified amount

stack?string

Group results by specified field. 'currency' groups balances by currency type

details?boolean

Include detailed breakdown of individual accounts and crypto assets

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/accounts/balance?customer_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&currency=str"
{
  "total_balance": 0,
  "currency": "EUR",
  "fiat_balance": 0,
  "crypto_balance": 0,
  "details": {
    "fiat_accounts": null,
    "crypto_assets": [
      {
        "id": "f17066c7-dbf8-47d8-ada6-b828701964be",
        "customer_id": "8f43255d-f71e-48a0-a925-54f1dc35e89d",
        "currency": "BTC",
        "balance": 0,
        "balance_in_base": 0,
        "is_crypto": true,
        "active": true,
        "status": "active",
        "main_wallet_address": "tb1qecx8j4kh7mfvh28hru0ckea8hzegd0984s0hdh",
        "main_wallet_address_tag": ""
      },
      {
        "id": "c079ff7a-09d6-41af-8f19-26c322004849",
        "customer_id": "8f43255d-f71e-48a0-a925-54f1dc35e89d",
        "currency": "BTC",
        "balance": 0,
        "balance_in_base": 0,
        "is_crypto": true,
        "active": false,
        "status": "active"
      },
      {
        "id": "fc7cc3c6-6b71-495f-8ed2-358fa75133b0",
        "customer_id": "8f43255d-f71e-48a0-a925-54f1dc35e89d",
        "currency": "BTC",
        "balance": 0,
        "balance_in_base": 0,
        "is_crypto": true,
        "active": false,
        "status": "active"
      }
    ]
  }
}
{
  "error": "string",
  "message": "string",
  "details": {}
}
{
  "error": "string",
  "message": "string",
  "details": {}
}
{
  "error": "string",
  "message": "string",
  "details": {}
}

GETList accounts (unified fiat and crypto) - V2

Retrieves a unified list of both traditional bank accounts and cryptocurrency accounts with comprehensive search, filtering, sorting, and pagination capabilities. This is the V2 implementation of the unified accounts API - recommended over V3. Supports advanced search operators for precise filtering, field-specific searches, and multiple response formats including stacked grouping. **Access Control:** - **Regular users**: Can only access accounts linked to their customers - **Administrator users**: Can access all accounts across all customers (with PermReadAll permission) - **Metadata**: Each account includes metadata with icon_url for currency representation

GETGet Account

Next Page