v8

OpenAPI 3.1.02026-08-033623795.0 MB

Disputes

List Disputes

Lists the disputes across the accounts you can read.

get/disputes

Query parameters

account_idstring

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

firstinteger

The number of disputes to return (default 20, max 100).

afterstring

A cursor; returns disputes after this position.

lastinteger

The number of disputes to return from the end of the range.

beforestring

A cursor; returns disputes before this position.

order'created_at' | 'amount' | 'evidence_due_at'

The field to sort disputes by.

direction'asc' | 'desc'

Sort direction.

statusstring[]

Only disputes in these statuses. Repeat the parameter to pass several — one paginated list covers all of them. Covers both chargebacks and inquiries at each stage.

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-07-31

Pins the request to a dated API version.

Response

disputes listed

Example response

{
  "data": [
    {
      "evidence_locked_reason": "submitted",
      "reason": "fraudulent",
      "status": "needs_response"
    }
  ]
}