Alerts

An Alert notifies you of activity on your Dwolla account that may need your attention, such as unusual transfer activity for one of your Customers. When an alert needs a response from you, it includes an actionRequired object whose description explains what to do. Alerts are returned newest first. Listing and retrieving alerts requires an application access token for your account.

Alerts are in active development and must be enabled for your account. If alerts aren’t enabled, listing alerts returns an empty list. To enable alerts, please reach out to Dwolla.

Alert links

Link	Description
`self`	URL of the Alert resource. GET this link to retrieve the alert.
`customer`	GET this link to retrieve the Customer the alert is about. Present only when the alert is related to a Customer.
`transfers`	GET this link to list the Customer’s transfers. Present only when the alert is related to a Customer’s transfers.

Alert resource

Parameter	Description
`_links`	A `_links` JSON object that contains links to the alert and related resources. See Alert links.
`id`	The alert’s unique identifier.
`type`	The kind of alert. Currently the only value is `unusual-transfer-activity`. More types may be added in the future, so handle values you don’t recognize.
`status`	Whether the alert is still open or has been resolved. Acceptable values: `open` or `resolved`.
`description`	A human-readable description of the alert.
`actionRequired`	An `actionRequired` JSON object that explains what you need to do to address the alert. Present only while action is required from you.
`created`	ISO-8601 timestamp of when the alert was created.
`lastUpdated`	ISO-8601 timestamp of when the alert last changed.
`resolved`	ISO-8601 timestamp of when the alert was resolved. Present only when the alert is resolved.
`unusualTransferActivity`	An `unusualTransferActivity` JSON object with details of the transfer activity that triggered the alert. Present only for alerts that include these details.

`actionRequired` object

More members may be added to this object in the future.

Parameter	Description
`description`	Instructions for addressing the alert, as plain text (not markdown). Paragraphs are separated by blank lines.

`unusualTransferActivity` object

Parameter	Description
`transferCount`	The number of transfers involved in the activity.
`totalAmount`	An Amount JSON object that contains `value` and `currency` keys. The total amount of the transfers involved.

{
  "_links": {
    "self": {
      "href": "https://api.dwolla.com/alerts/d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42",
      "type": "application/vnd.dwolla.v1.hal+json",
      "resource-type": "alert"
    },
    "customer": {
      "href": "https://api.dwolla.com/customers/b0e1c5a6-2f3d-4e7a-8c9b-1d2e3f4a5b6c",
      "type": "application/vnd.dwolla.v1.hal+json",
      "resource-type": "customer"
    },
    "transfers": {
      "href": "https://api.dwolla.com/customers/b0e1c5a6-2f3d-4e7a-8c9b-1d2e3f4a5b6c/transfers",
      "type": "application/vnd.dwolla.v1.hal+json",
      "resource-type": "transfer"
    }
  },
  "id": "d4bd3a1e-7c6e-4e8a-9a5c-3b2f9d7e1a42",
  "type": "unusual-transfer-activity",
  "status": "open",
  "description": "Unusual transfer activity was detected for one of your customers.",
  "actionRequired": {
    "description": "Your feedback is required to complete this customer's review. Please review the activity and email risk@dwolla.com to confirm the appropriate action.\n\nApprove Transfers: Activity is expected.\nSuspend Customer: Activity is not expected.\n\nPlease include the customer ID and provide an explanation for the proposed action. We will reach out if we require more information."
  },
  "created": "2026-10-14T16:32:08.000Z",
  "lastUpdated": "2026-10-14T16:32:08.000Z",
  "unusualTransferActivity": {
    "transferCount": 12,
    "totalAmount": {
      "value": "48250.00",
      "currency": "USD"
    }
  }
}

Pagination

List alerts returns 10 alerts per page using cursor-based pagination:

Request GET /alerts to get the first page, which contains your newest alerts.
Follow the next link in _links to get the next page of older alerts. next is omitted on the last page.
Follow the prev link in _links to go back to the previous page of newer alerts. prev is omitted on the first page.
To list only open or only resolved alerts, add the status query parameter to your first request, such as GET /alerts?status=open. The next and prev links keep the filter.

The next and prev link URLs contain an opaque cursor. Use them exactly as returned; don’t build, parse, or modify them. See List alerts for the full pagination and filtering rules.

Introduction

Resources

Overview

Alerts

Alert links

Alert resource

`actionRequired` object

`unusualTransferActivity` object

​Alerts

​Alert links

​Alert resource

​actionRequired object

​unusualTransferActivity object

​Pagination

Alerts

Alert links

Alert resource

`actionRequired` object

`unusualTransferActivity` object

Pagination