Retrieve Dispute Summary
Totals up the same disputes the list returns, so you can build status tabs and totals without paging through them.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-11-03-1"
Query Parameters
Which breakdowns to return, keyed by these names under groups. Repeat the parameter to ask for several; omit it for all of them.
status, currency Only disputes filed against this account (biz_ tag). Omit it to cover every account you can read.
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, warning_needs_response, under_review, warning_under_review, won, lost, prevented, warning_closed Only disputes in this three-letter ISO currency.
Only disputes opened before this ISO 8601 timestamp.
Only disputes opened after this ISO 8601 timestamp.
Search disputes by dispute ID, payment ID, user ID, membership ID, user email, name, or username. Email filtering requires the member:email:read permission.
Also cover the account's subaccounts. Requires account_id, and is a 400 without it. Without query, covers the disputes of the account and every subaccount, in any order. The listing is cut off after 10 seconds; add a query to narrow it. With query, matches on dispute, payment, user or membership ID, buyer email, or a card's first 6 or 8 digits and last 4 separated by a space or dash (424242 4242); free-text queries such as a name search only the named account. Subaccounts' disputes are returned only for subaccounts you can read disputes on.

