---
title: "Retrieve Dispute Alert"
method: GET
path: "/dispute_alerts/{id}"
tags: ["Dispute alerts"]
---

# Retrieve Dispute Alert

`GET /dispute_alerts/{id}`

Retrieves a single dispute alert or early fraud warning by ID.

## Path parameters

- `id` string, required

## Headers

- `Api-Version-Date` string

## Response `200`

dispute alert returned

- DisputeAlert
  - `account_id` string, nullable, required — The account the alerted payment belongs to, prefixed `biz_`. `null` while the alert is unmatched.
  - `amount` number, required — The alerted amount, in whole units of `currency`. This is what the issuer reported, which can differ from the payment's own amount.
  - `auto_refunded` boolean, required — Whether Whop automatically refunded the alerted payment. Reflects the payment, so it can be `true` for a refund issued by another flow (RDR, resolution) on the same payment.
  - `card_brand` string, nullable, required — The card network as reported by the issuer, lowercased, such as `visa` or `mastercard`. `unknown` when the report carries neither a network nor a recognizable BIN.
  - `created_at` string, required — When Whop received the alert, as an ISO 8601 timestamp.
  - `currency` string, required — Three-letter ISO currency code of the alerted amount.
  - `fee_charged` boolean, required — Whether Whop charged the account an alert fee for this one. Always `false` for `early_fraud_warning`, which Whop is not billed for and never passes on.
  - `id` string, required — Dispute alert ID, prefixed `dspa_`.
  - `issuer` string, nullable, required — Deprecated: always `null` outside Whop's own dashboard. Name of the bank that issued the card and filed the report. DEPRECATED: Always null outside Whop's own dashboard.
  - `payment_id` string, nullable, required — The payment the issuer reported, prefixed `pay_`. `null` when Whop could not match the report to a payment.
  - `product_id` string, nullable, required — The product the alerted payment was for, prefixed `prod_`.
  - `reported_at` string, required — When the issuer filed the report, as an ISO 8601 timestamp. Earlier than `created_at`, which is when Whop received it.
  - `transaction_at` string, nullable, required — When the reported transaction was made, as an ISO 8601 timestamp — falls back to when the matched payment was made if the issuer's own report didn't carry one. Should not be `null` in practice; treat one as a data issue rather than expected behavior.
  - `type` 'early_fraud_warning' | 'dispute_alert' | 'rapid_dispute_resolution', required — What the issuer sent. `early_fraud_warning` is a fraud report on a settled payment (Visa TC40 / Mastercard SAFE) — refunding still avoids the chargeback, and Whop never charges a fee for one. `dispute_alert` is a pre-dispute notice from the issuer's alert network, which Whop pays for and passes on as a fee. `rapid_dispute_resolution` is a Visa RDR case the network already closed by refunding the payment — nothing is left to act on.
  - `updated_at` string, required — When the alert was last changed, as an ISO 8601 timestamp.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource not found

## Changes

> 71 revisions in range; 1 not diffed.

- **2026-09-25** `c1dceb26e505` — 1 info
  - added the required property `auto_refunded` to the response with the `200` status
- **2026-09-23** `140d015b9966` — 2 breaking, 1 info
  - removed the required property `actionable` from the response with the `200` status
  - removed the required property `not_actionable_reason` from the response with the `200` status
  - response property `issuer` deprecated
- **2026-08-12** `6fb1c04bf255` — 6 breaking, 3 warning, 112 info
  - the `created_at` response's property format changed from `date-time` to no format for status `200`
  - removed the required property `alert_type` from the response with the `200` status
  - removed the required property `charge_for_alert` from the response with the `200` status
  - removed the required property `dispute` from the response with the `200` status
  - …117 more
- **2026-07-26** `60bbb4a6ffbc` — 1 warning
  - added the new `bank_wire` enum value to the `payment/payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/dispute_alerts/:id/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/c1dceb26e505?raw)