---
title: "List dispute alerts"
method: GET
path: "/dispute_alerts"
tags: ["Dispute alerts"]
---

# List dispute alerts

`GET /dispute_alerts`

Returns a paginated list of dispute alerts for a company, with optional filtering by creation date.

Required permissions:
 - `payment:dispute_alert:read`
 - `payment:basic:read`
 - `payment:dispute:read`

## Query parameters

- `after` string, nullable — Returns the elements in the list that come after the specified cursor.
- `before` string, nullable — Returns the elements in the list that come before the specified cursor.
- `first` integer, nullable — Returns the first _n_ elements from the list.
- `last` integer, nullable — Returns the last _n_ elements from the list.
- `company_id` string, required — The unique identifier of the company to list dispute alerts for.
- `direction` 'asc' | 'desc' — The direction of the sort.
- `created_before` string, date-time, nullable — Only return dispute alerts created before this timestamp.
- `created_after` string, date-time, nullable — Only return dispute alerts created after this timestamp.

## Response `200`

A successful response

- object — The connection type for DisputeAlert.
  - `data` DisputeAlertListItem[], required — A list of nodes.
    - `alert_type` 'dispute' | 'dispute_rdr' | 'fraud', required — The type of dispute alert.
    - `amount` number, required — The alerted amount in the specified currency.
    - `charge_for_alert` boolean, required — Whether this alert incurs a charge.
    - `created_at` string, date-time, required — The time the dispute alert was created.
    - `currency` 'usd' | 'sgd' | 'inr' | 'aud' | 'brl' | 'cad' | 'dkk' | 'eur' | 'nok' | 'gbp' | 'sek' | 'chf' | 'hkd' | 'huf' | 'jpy' | 'mxn' | 'myr' | 'pln' | 'czk' | 'nzd' | 'aed' | 'eth' | 'ape' | 'cop' | 'ron' | 'thb' | 'bgn' | 'idr' | 'dop' | 'php' | 'try' | 'krw' | 'twd' | 'vnd' | 'pkr' | 'clp' | 'uyu' | 'ars' | 'zar' | 'dzd' | 'tnd' | 'mad' | 'kes' | 'kwd' | 'jod' | 'all' | 'xcd' | 'amd' | 'bsd' | 'bhd' | 'bob' | 'bam' | 'khr' | 'crc' | 'xof' | 'egp' | 'etb' | 'gmd' | 'ghs' | 'gtq' | 'gyd' | 'ils' | 'jmd' | 'mop' | 'mga' | 'mur' | 'mdl' | 'mnt' | 'nad' | 'ngn' | 'mkd' | 'omr' | 'pyg' | 'pen' | 'qar' | 'rwf' | 'sar' | 'rsd' | 'lkr' | 'tzs' | 'ttd' | 'uzs' | 'rub' | 'btc' | 'cny' | 'usdt' | 'kzt' | 'awg' | 'whop_usd' | 'xau', required — The available currencies on the platform
    - `dispute` object, nullable, required — The dispute associated with the dispute alert.
      - `id` string, required — The unique identifier for the dispute.
    - `id` string, required — The unique identifier of the dispute alert.
    - `payment` object, nullable, required — The payment associated with the dispute alert.
      - `id` string, required — The unique identifier for the payment.
    - `transaction_date` string, date-time, nullable, required — The date of the original transaction.
  - `page_info` PageInfo, required — Information about pagination in a connection.
    - `end_cursor` string, nullable, required — When paginating forwards, the cursor to continue.
    - `has_next_page` boolean, required — When paginating forwards, are there more items?
    - `has_previous_page` boolean, required — When paginating backwards, are there more items?
    - `start_cursor` string, nullable, required — When paginating backwards, the cursor to continue.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Verification required
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)