Sign in
latestOpenAPI 3.1.02026-08-223914256.0 MB

f1cf47ad0ec2

Disputes

Retrieve Dispute Summary

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

get/disputes/summary

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-08-21

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
}