---
title: "List disputes"
method: GET
path: "/disputes"
tags: ["Disputes API"]
---

# List disputes

`GET /disputes`

Returns a paginated list of disputes.

## Query parameters

- `limit` integer
- `created_after` string
- `created_before` string
- `resolved_after` string
- `resolved_before` string
- `status` 'action_required_merchant' | 'no_merchant_action_needed' | 'closed_customer_favor' | 'closed_merchant_favor' | 'closed_customer_partial_favor'
- `dispute_reason` 'cancellation_or_return_not_processed' | 'incorrect_amount' | 'product_not_received' | 'product_unacceptable' | 'cancellation_not_processed' | 'return_not_processed' — Enum for dispute reason values.
- `merchant_id` string
- `page_number` string

## Response `200`

Success

- object — Response model for list disputes API.
  - `token` string
  - `disputes` DisputeSummary[], required — List of dispute summaries
    - `created` string, date-time, required — When dispute was created
    - `currency` string, required — Currency code (ISO 4217)
    - `dispute_amount` integer, required — Dispute amount in the smallest denomination of the currency
    - `dispute_reason` 'cancellation_or_return_not_processed' | 'incorrect_amount' | 'product_not_received' | 'product_unacceptable' | 'cancellation_not_processed' | 'return_not_processed' — Enum for dispute reason values.
    - `id` string, required — ID of the dispute
    - `merchant_id` string, required — ID of the merchant associated with the dispute
    - `response_due_by` string, date-time, nullable
    - `status` string, required — Current status of the dispute
    - `transaction_id` string, required — ID of the transaction associated with the dispute
    - `updated` string, date-time, nullable
  - `page_info` PageInfo, required — Pagination information.
    - `has_next` boolean, required — Whether more results exist after this page
    - `has_prev` boolean, required — Whether previous page exists

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/affirm/apis/merchant-transaction-api.md) · [All operations](https://skmtc.dev/affirm/apis/merchant-transaction-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/affirm/merchant-transaction-api/revisions/f2f4252c946f/schema)