---
title: "Retrieve Dispute Summary"
method: GET
path: "/disputes/summary"
tags: ["Disputes"]
---

# Retrieve Dispute Summary

`GET /disputes/summary`

Totals up the same disputes the list returns, so you can build status tabs and totals without paging through them.

## Query parameters

- `groups` string[]
- `account_id` string
- `status` string[]
- `currency` string
- `created_before` string
- `created_after` string

## Headers

- `Api-Version-Date` string

## Response `200`

summary returned

- object
  - `groups` object, required — One entry per requested breakdown, keyed by the field it groups on. A field you did not ask for is absent.
    - `currency` object — How many of the matching disputes are in each currency, keyed by three-letter ISO code. Only currencies with at least one dispute are present.
    - `status` object — How many of the matching disputes are in each status. Every status is present, including those with a count of zero.
      - `closed` integer, required
      - `lost` integer, required
      - `needs_response` integer, required
      - `under_review` integer, required
      - `won` integer, required
  - `total` integer, required — How many disputes match the filters.

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized

## Changes

- **2026-08-07** `f1020c3ecda4` — 2 info
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/code` to the response with the `401` status
- **2026-07-26** `60bbb4a6ffbc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/disputes/summary/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-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/9e320991dd2f/schema)