Dwolla Developers Logo
Back
API Reference
  • SDK Support
    Drop-in Components
    Authorization
    Root
    Accounts
    OverviewRetrieve account detailsCreate a funding source for an accountList funding sources for an accountList and search transfers for an accountList mass payments for an account
    Customers
    Knowledge-based Authentication (KBA)
    Beneficial Owners
    Documents
    Funding Sources
    Transfers
    Mass payments
    Labels
    Events
    Webhook subscriptions
    Webhooks
CommunityOpen in new tabChangelog
Get API Keys
CommunityOpen in new tabChangelog
JavaScript
Get API Keys

List and search transfers for an account #

This section covers how to retrieve an Account's list of transfers. Transaction search is supported by passing in optional query string parameters such as: search which represents a term to search on, correlationId, startAmount, endAmount, startDate, endDate, and status.

Note: You can only retrieve up to 10,000 transfers using the limit and offset query string parameters. To retrieve historical transactions that exceed that limit, startDate and endDate query string parameters must be used to further limit the search. For example, if item 10,000 has a date of 2021-01-01 the next request can be the following,

GET https://api.dwolla.com/accounts/{id}/transfers?search={term}&endDate=2021-01-01

HTTP request #

GET https://api.dwolla.com/accounts/{id}/transfers

Request parameters #

ParameterRequiredTypeDescriptionidyesstringAccount unique identifier to get transfers for.searchnostringA string to search on fields: firstName, lastName, email, businessName, Customer Id, and Account Id. (/transfers?search=Doe)startAmountnostringOnly include transactions with an amount equal to or greater than startAmount. Can optionally be used with endAmount to specify an amount range.endAmountnostringOnly include transactions with an amount equal to or less than endAmount. Can optionally be used with startAmount to specify an amount range.startDatenostringOnly include transactions created after this date. ISO-8601 format: YYYY-MM-DD. Can optionally be used with endDate to specify a date range.endDatenostringOnly include transactions created before than this date. ISO-8601 format: YYYY-MM-DD. Can optionally be used with startDate to specify a date range.statusnostringFilter results on transaction status. Possible values: pending, processed, failed, or cancelled.correlationIdnostringA string value to search on if a correlationId was specified on a transfer or mass payment item.limitnointegerNumber of search results to return. Defaults to 25.offsetnointegerNumber of search results to skip. Used for pagination.

HTTP status and error codes #

HTTP StatusMessage404Account not found.

Request and response #

JavaScript
// Using dwolla-v2 - https://github.com/Dwolla/dwolla-v2-node
var accountUrl =
  "https://api-sandbox.dwolla.com/accounts/62e88a41-f5d0-4a79-90b3-188cf11a3966";

dwolla
  .get(`${accountUrl}/transfers`)
  .then((res) => res.body._embedded["transfers"][0].status); // => 'processed'

Test in the Sandbox for free today.

Use sandbox environment to test API requests.

Get API Keys
2022 All Rights Reserved

Dwolla

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

All funds transfers made using the Dwolla Platform are performed by a financial institution partner, and any funds held in a Dwolla Balance are held by a financial institution partner. Learn more about our financial institution partners.