Dwolla Developers Logo
Back
API Reference
CommunityOpen in new tabChangelog
Get API Keys
CommunityOpen in new tabChangelog
JavaScript
Get API Keys

Retrieve a funding source balance #

This section covers how to retrieve the total and available amount for a Dwolla balance funding source. The funding source type balance exists for Verified Customer accounts and represents a balance held in the Dwolla network.

Total and Available Balance

There are two different amounts returned in the API response when retrieving a balance which correspond to a total and available balance. Note: Unless your application utilizes Labels functionality, the amounts that are returned in both the balance and total objects will be the same. Available balance can be accessed via the balance attribute, whereas total balance can be accessed via the total attribute within the Balance object. Both balance and total are JSON objects that contain key value pairs for value and currency.

Available Balance

The amount of funds readily available in a Verified Customer Record’s balance that can be sent, withdbashn, or labeled.

Total Balance

Represents the Verified Customer Record’s total balance held in the Dwolla network. This includes both labeled funds and the Available Balance, i.e. both labeled and unlabeled funds.

HTTP request #

GET https://api.dwolla.com/funding-sources/{id}/balance

Request parameters #

ParameterRequiredTypeDescriptionidyesstringid of funding source to retrieve a balance for.

HTTP status and error codes #

HTTP StatusCodeDescription404NotFoundFunding source not found.

Request and response #

JavaScript
var fundingSourceUrl =
  "https://api-sandbox.dwolla.com/funding-sources/c2eb3f03-1b0e-4d18-a4a2-e552cc111418";

dwolla.get(`${fundingSourceUrl}/balance`).then((res) => res.body.balance.value);

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys
2021 All Rights Reserved

Dwolla

  • About
  • Blog
  • Pricing
  • Contact Sales
  • Terms of Service
  • Privacy Policy
Financial institutions play an important role in our network.

Dwolla, Inc. is the operator of a software platform that communicates user instructions for funds transfers to our financial institution partners.

Dwolla is an agent of Veridian Credit Union. All ACH and Wire transfers are performed by Veridian Credit Union. Your Dwolla Balance, if any, is held in one or more pooled holding accounts held by Veridian Credit Union. These funds may not be eligible for share insurance by the National Credit Union Share Insurance Fund.

Sponsorship and Settlement of Push-to-Debit payment services provided by MetaBank®, N.A.
Push-to-Debit payments are typically available within 30 minutes.

Real-Time Payments are performed by Cross River Bank, which holds funds on behalf of the Receiver of such transactions in one or more pooled custodial accounts. These funds are not subject to FDIC pass-through deposit insurance.