BALANCES

List balances

GEThttps://production.dutchapi.co/v1/balances

Returns the available balance of every wallet on your organization.

🔒Send the project API key as a Bearer token and your Business ID with this call.

Responses

{
  "object": "list",
  "data": [
    {
      "currency": "XAF",
      "available": 359700,
      "kind": "fiat"
    },
    {
      "currency": "USD",
      "available": 120.5,
      "kind": "fiat"
    },
    {
      "currency": "USDT",
      "available": 25,
      "kind": "stablecoin"
    }
  ]
}

{
  "error": "insufficient_scope",
  "message": "This project key is not allowed to do that."
}

Errors

Status	error	Meaning
403	`insufficient_scope`	This project key is not allowed to do that.

Updated 2026

Did this page help you?

PreviousCheck your key NextQuote a payout

Language

CredentialsBearer

curl --request GET --url "https://production.dutchapi.co/v1/balances" \
  --header "Authorization: Bearer $DUTCH_PROJECT_KEY" \
  --header "X-Business-Id: $DUTCH_BUSINESS_ID"

const res = await fetch("https://production.dutchapi.co/v1/balances", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.DUTCH_PROJECT_KEY,
    "X-Business-Id": process.env.DUTCH_BUSINESS_ID,
  }
});
console.log(await res.json());

require "net/http"
require "json"

uri = URI("https://production.dutchapi.co/v1/balances")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch('DUTCH_PROJECT_KEY')}"
req["X-Business-Id"] = ENV.fetch("DUTCH_BUSINESS_ID")
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

<?php
$ch = curl_init("https://production.dutchapi.co/v1/balances");
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("DUTCH_PROJECT_KEY"),
    "X-Business-Id: " . getenv("DUTCH_BUSINESS_ID")],
]);
echo curl_exec($ch);

import os, requests

res = requests.request(
    "GET",
    "https://production.dutchapi.co/v1/balances",
    headers={
        "Authorization": "Bearer " + os.environ["DUTCH_PROJECT_KEY"],
        "X-Business-Id": os.environ["DUTCH_BUSINESS_ID"],
    }
)
print(res.json())

Response

Click `Show example` to see an example response. Nothing is sent from this page: endpoints are live, so run real requests from your own code with small amounts.