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

# List Disputes

`GET /disputes`

## Request

- Base URL: `https://api.justifi.ai/v1`
- URL: `https://api.justifi.ai/v1/disputes`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/justifi/apis/justifi-api-documentation/docs/disputes/get.ts> (a function with typed inputs; its response is checked against the schema)

Any disputes associated with a payment are also included in the response of the [get payment API](https://docs.justifi.tech/api-spec#tag/Payments/operation/GetPayment) and the [list payments API](https://docs.justifi.tech/api-spec#tag/Payments/operation/ListPayments) response

## Headers

- `Authorization` string, required
- `Sub-Account` string

## Response `200`

Successfully list disputes

- object
  - `id` number: the object id
  - `type` string: the object type, or array of objects
  - `data` Dispute[]: the list of objects
    - `id` string: unique dispute id
    - `payment_id` string, uuid: the disputed payment
    - `account_id` string, uuid: id of the account associated with the dispute
    - `amount` number: amount disputed in cents
    - `currency` 'usd' | 'cad'
    - `reason` string: the reason this payment was disputed
    - `due_date` string, date: due date for evidence submission to counter the dispute
    - `status` 'needs_response' | 'under_review' | 'won' | 'lost': status of the dispute
    - `metadata` object: any useful information you'd like to store alongside this dispute
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `dispute_response` object, nullable: present when evidence was submitted to counter dispute
      - `additional_statement` string: any additional evidence or statements
      - `cancellation_policy_disclosure` string: an explanation of how and when the customer was shown your cancellation policy prior to purchase
      - `cancellation_rebuttal` string: a justification for why the customer’s subscription was not canceled
      - `customer_billing_address` string: the billing address provided by the customer
      - `customer_email_address` string: the email address of the customer
      - `customer_name` string: the name of the customer
      - `customer_purchase_ip_address` string: the IP address that the customer used when making the purchase
      - `duplicate_charge_explanation` string: an explanation of the difference between the disputed charge versus the prior charge that appears to be a duplicate
      - `product_description` string: a description of the product or service that was sold
      - `refund_policy_disclosure` string: documentation demonstrating that the customer was shown your refund policy prior to purchase
      - `refund_refusal_explanation` string: justification for why the customer is not entitled to a refund
      - `service_date` string: the date on which the customer received or began receiving the purchased service
      - `shipping_address` string: the address to which a physical product was shipped
      - `shipping_carrier` string: the delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc. If multiple carriers were used for this purchase, please separate them with commas
      - `shipping_date` string: the date on which a physical product began its route to the shipping address
      - `shipping_tracking_number` string: the tracking number for a physical product. If multiple tracking numbers were generated for this purchase, please separate them with commas
      - `duplicate_charge_original_payment_id` string: the payment id for the prior charge which appears to be a duplicate of the disputed charge
    - `dispute_reversal` object, nullable: present when dispute gets reversed from lost to won
      - `description` string
      - `created_at` string, date-time
  - `page_info` PageInfo
    - `end_cursor` string: the encoded id of the last record in the current list
    - `has_next` boolean: true if the collection contains records following the current list
    - `has_previous` boolean: true if the collection contains records ahead of the current list
    - `start_cursor` string: the encoded id of the first record in the current list

---

[API](https://skmtc.dev/justifi/apis/justifi-api-documentation.md) - [All operations](https://skmtc.dev/justifi/apis/justifi-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/justifi/apis/justifi-api-documentation/revisions/dd9f3fed7e46?raw)