---
title: "ListDisputes"
method: GET
path: "/v2/disputes"
tags: ["Disputes"]
---

# ListDisputes

`GET /v2/disputes`

Returns a list of disputes associated with a particular account.

## Query parameters

- `cursor` string
- `states` string
- `location_id` string

## Response `200`

Success

- ListDisputesResponse — Defines fields in a `ListDisputes` response.
  - `cursor` string — The pagination cursor to be used in a subsequent request. If unset, this is the final response. For more information, see [Pagination](https://developer.squareup.com/docs/basics/api101/pagination).
  - `disputes` Dispute[] — The list of disputes.
    - `amount_money` Money — Represents an amount of money. `Money` fields can be signed or unsigned. Fields that do not explicitly define whether they are signed or unsigned are considered unsigned and can only hold positive amounts. For signed fields, the sign of the value indicates the purpose of the money transfer. See [Working with Monetary Amounts](https://developer.squareup.com/docs/build-basics/working-with-monetary-amounts) for more information.
      - `amount` integer — The amount of money, in the smallest denomination of the currency indicated by `currency`. For example, when `currency` is `USD`, `amount` is in cents. Monetary amounts can be positive or negative. See the specific field description to determine the meaning of the sign in a particular case.
      - `currency` string — The type of currency, in __ISO 4217 format__. For example, the currency code for US dollars is `USD`. See [Currency](https://developer.squareup.com/reference/square_2021-08-18/enums/Currency) for possible values.
    - `brand_dispute_id` string — The ID of the dispute in the card brand system, generated by the card brand.
    - `card_brand` string — The card brand used in the disputed payment.
    - `created_at` string — The timestamp when the dispute was created, in RFC 3339 format.
    - `dispute_id` string — The unique ID for this `Dispute`, generated by Square.
    - `disputed_payment` DisputedPayment — The payment the cardholder disputed.
      - `payment_id` string — Square-generated unique ID of the payment being disputed.
    - `due_at` string — The time when the next action is due, in RFC 3339 format.
    - `evidence_ids` string[] — The IDs of the evidence associated with the dispute.
    - `id` string — The unique ID for this `Dispute`, generated by Square.
    - `location_id` string — The ID of the location where the dispute originated.
    - `reason` string — The dispute reason why the cardholder initiated the dispute with their bank.
    - `reported_at` string — The timestamp when the dispute was reported, in RFC 3339 format.
    - `reported_date` string — The timestamp when the dispute was reported, in RFC 3339 format.
    - `state` string — The current state of this dispute.
    - `updated_at` string — The timestamp when the dispute was last updated, in RFC 3339 format.
    - `version` integer — The current version of the `Dispute`.
  - `errors` Error[] — Information about errors encountered during the request.
    - `category` string, required — The high-level category for the error.
    - `code` string, required — The specific code of the error.
    - `detail` string — A human-readable description of the error for debugging purposes.
    - `field` string — The name of the field provided in the original request (if any) that the error pertains to.

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/revisions/8d95e3639487/schema)