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

# List disputes

`GET /disputes`

## Request

- Base URL: `https://sandbox.affirm.com/api/v3`
- URL: `https://sandbox.affirm.com/api/v3/disputes`
- Auth: none declared

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/affirm-disputes-api.md) - [All operations](https://skmtc.dev/affirm/apis/affirm-disputes-api/llms.txt) - [OpenAPI document](https://skmtc.dev/affirm/apis/affirm-disputes-api/revisions/c6ae26b115a4?raw)