Sign in
latestOpenAPI 3.1.02026-08-223914256.0 MB

f1cf47ad0ec2

Dispute alerts

List Dispute Alerts

Lists the dispute alerts and early fraud warnings across the accounts you can read.

get/dispute_alerts

Query parameters

account_idstring

Only alerts on this account's payments (biz_ tag). Omit it to cover every account you can read.

payment_idstring

Only alerts on this payment (pay_ tag). A payment can carry several.

type'early_fraud_warning' | 'dispute_alert' | 'rapid_dispute_resolution'

Only alerts of this kind. early_fraud_warning for issuer fraud reports, dispute_alert for pre-dispute notices, rapid_dispute_resolution for Visa RDR cases the network already closed.

firstinteger

The number of alerts to return (default 20, max 100).

afterstring

A cursor; returns alerts after this position.

lastinteger

The number of alerts to return from the end of the range.

beforestring

A cursor; returns alerts before this position.

order'created_at' | 'reported_at' | 'amount'

The field to sort alerts by.

direction'asc' | 'desc'

Sort direction.

created_beforestring

Only alerts Whop received before this ISO 8601 timestamp.

created_afterstring

Only alerts Whop received after this ISO 8601 timestamp.

Headers

Api-Version-Datestring
Example:2026-08-21

Pins the request to a dated API version.

Response

dispute alerts listed

Example response

{
  "data": [
    {
      "account_id": "biz_xxxxxxxxxxxxxx",
      "amount": 25,
      "card_brand": "visa",
      "created_at": "2026-01-01T12:00:00.000Z",
      "currency": "usd",
      "id": "dspa_xxxxxxxxxxxxxx",
      "not_actionable_reason": "network_resolved",
      "payment_id": "pay_xxxxxxxxxxxxxx",
      "product_id": "prod_xxxxxxxxxxxxxx",
      "reported_at": "2026-01-01T12:00:00.000Z",
      "transaction_at": "2026-01-01T12:00:00.000Z",
      "type": "rapid_dispute_resolution",
      "updated_at": "2026-01-01T12:00:00.000Z"
    }
  ],
  "page_info": {
    "end_cursor": "WyJjdXJzb3IiLDFd",
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}