> ## Documentation Index
> Fetch the complete documentation index at: https://developers.dwolla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Alerts notify you of activity on your Dwolla account that may need your attention. List or retrieve alerts using the Dwolla API.

# 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](https://developers.dwolla.com/docs/api-reference/customers.md). 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](https://developers.dwolla.com/docs/api-reference/tokens/create-an-application-access-token.md) for your account.

> [!WARNING]
>
> 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](https://www.dwolla.com/contact?b=apidocs).

### Alert links

| Link | Description |
| - | - |
| `self` | URL of the Alert resource. GET this link to [retrieve the alert](https://developers.dwolla.com/docs/api-reference/alerts/retrieve-alert.md). |
| `customer` | GET this link to [retrieve the Customer](https://developers.dwolla.com/docs/api-reference/customers/retrieve-a-customer.md) the alert is about. **Present only when the alert is related to a Customer.** |
| `transfers` | GET this link to [list the Customer's transfers](https://developers.dwolla.com/docs/api-reference/transfers/list-and-search-transfers-for-a-customer.md). **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](#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`](#actionrequired-object) 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`](#unusualtransferactivity-object) 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](https://developers.dwolla.com/docs/api-reference/transfers.md#amount-json-object) JSON object that contains `value` and `currency` keys. The total amount of the transfers involved. |

```json theme={"dark"}
{
  "_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](https://developers.dwolla.com/docs/api-reference/alerts/list-alerts.md) 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](https://developers.dwolla.com/docs/api-reference/alerts/list-alerts.md) for the full pagination and filtering rules.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.