**Version: 202601**

# List disputes

**GET** `/openapi/2026-01/shoplazza-payment/disputes`

Returns a paginated list of disputes, optionally filtered by status and creation time range.

## Request

**Query Parameters**

- `cursor` string

  Cursor for pagination
- `page_size` int32

  Page size (1-100, default 10)
- `status` string

  Filter disputes by status:

  *   `lost`: dispute resolved against the merchant; funds were not recovered
  *   `won`: dispute resolved in favor of the merchant; funds were retained or recovered
  *   `warning_closed`: warning-type dispute case closed; no further action required
  *   `needs_response`: dispute requires a response or evidence from the merchant to proceed
  *   `under_review`: dispute is being reviewed by the payment processor or financial institution
  *   `warning_under_review`: warning-type dispute is under review; further action may be needed
  *   `warning_needs_response`: warning-type dispute awaiting merchant response to avoid escalation
- `created_at_min` string

  Filter disputes created at or after this Unix timestamp (e.g., 1730548810)
- `created_at_max` string

  Filter disputes created at or before this Unix timestamp (e.g., 1730548810)

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `list` object[]

    List of dispute records

    *   Array \[

    - `id` string

      Dispute ID
    - `transaction_order_id` string

      Transaction order ID related to the dispute
    - `original_order_id` string

      Original order ID related to the transaction
    - `store_id` string

      Store ID
    - `currency` string

      Currency code of the dispute amount
    - `created_at` string

      Creation time of the dispute in ISO 8601 format
    - `updated_at` string

      Last updated time of the dispute in ISO 8601 format
    - `expiration_time` string

      Expiration time for responding to the dispute
    - `dispute_reason` string

      Reason provided for the dispute
    - `original_order_amount` string

      Total amount of the original order
    - `dispute_amount` string

      Amount of the dispute
    - `status` string

      Current status of the dispute. Possible values: won, lost, under\_review, etc
    - `fee` string

      Fees associated with the dispute
    - `fee_currency` string

      Currency of the associated fee
    *   \]
  - `cursor` string

    Cursor for pagination
  - `has_more` boolean

    Whether there are more records

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "id": "string",
        "transaction_order_id": "string",
        "original_order_id": "string",
        "store_id": "string",
        "currency": "string",
        "created_at": "string",
        "updated_at": "string",
        "expiration_time": "string",
        "dispute_reason": "string",
        "original_order_amount": "string",
        "dispute_amount": "string",
        "status": "string",
        "fee": "string",
        "fee_currency": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```