Disputes

Retrieve Dispute Summary

Changed on

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

get/disputes/summary

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/disputes/summary
  • Auth: HTTP bearer

Query parameters

groupsstring[]

Which breakdowns to return, keyed by these names under groups. Repeat the parameter to ask for several; omit it for all of them.

[
  "status"
]
account_idstring

Only disputes filed against this account (biz_ tag). Omit it to cover every account you can read.

statusstring[]

Only disputes in these statuses. Repeat the parameter to pass several. A needs_response dispute whose evidence deadline has passed reports and filters as under_review instead.

[
  "needs_response"
]
currencystring

Only disputes in this three-letter ISO currency.

created_beforestring

Only disputes opened before this ISO 8601 timestamp.

created_afterstring

Only disputes opened after this ISO 8601 timestamp.

Headers

Api-Version-Datestring
Example:2026-10-13-1

Pins the request to a dated API version.

Response

summary returned

totalinteger required

How many disputes match the filters.

Example response

{
  "groups": {
    "currency": {
      "usd": 1
    },
    "status": {
      "needs_response": 1
    }
  },
  "total": 1
}

Changes

  • 352a8604a788Revision changes
    • breaking

      removed the enum value closed from the property items/ of the query request parameter status

    • breaking

      removed the required property // from the response with the status

    • info

      added the enum value prevented to the property items/ of the query request parameter status

    • info

      added the required property // to the response with the status

  • 86b97292852dRevision changes
    • info

      added the enum value warning_closed to the property items/ of the query request parameter status

    • info

      added the enum value warning_needs_response to the property items/ of the query request parameter status

    • info

      added the enum value warning_under_review to the property items/ of the query request parameter status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status