Sign in
Disputes

List Disputes

Lists the disputes across the accounts you can read.

get/disputes

Query parameters

account_idstring

Only disputes filed against this account (biz_ tag). Omit it to cover every account you can read.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

order'created_at' | 'amount' | 'evidence_due_at'

The field to sort disputes by.

direction'asc' | 'desc'

Sort direction.

statusstring[]

Only disputes in these statuses. Repeat the parameter to pass several — one paginated list covers all of them. Covers both chargebacks and inquiries at each stage. A needs_response dispute whose evidence deadline has passed reports and filters as under_review instead.

[
  "needs_response"
]
currencystring

Only disputes in this three-letter ISO currency.

created_beforestring

Only disputes opened before this ISO 8601 timestamp.

created_afterstring

Only disputes opened after this ISO 8601 timestamp.

Headers

Api-Version-Datestring
Example:2026-09-22-4

Pins the request to a dated API version.

Response

disputes listed

Example response

{
  "data": [
    {
      "account_id": "biz_xxxxxxxxxxxxxx",
      "amount": 150,
      "buyer": {
        "email": "marcus@shinetime.example",
        "member_id": "mber_xxxxxxxxxxxxxx",
        "name": "Dana Whitfield",
        "user_id": "user_xxxxxxxxxxxxxx",
        "username": "danawhitfield"
      },
      "created_at": "2026-01-01T12:00:00.000Z",
      "currency": "usd",
      "evidence": {
        "access_activity_log": "Vehicle checked in 2026-01-04 09:02, released 2026-01-05 16:40. Signed release on file.",
        "billing_address": "4180 Burnet Rd, Austin, TX 78756, US",
        "cancellation_policy_attachment": {
          "content_type": "image/png",
          "filename": "booking-confirmation-email.png",
          "id": "file_xxxxxxxxxxxxxx",
          "url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        },
        "cancellation_policy_disclosure": "Shown at checkout and again in the booking confirmation email.",
        "customer_communication_attachment": {
          "content_type": "image/png",
          "filename": "booking-confirmation-email.png",
          "id": "file_xxxxxxxxxxxxxx",
          "url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        },
        "customer_email_address": "marcus@shinetime.example",
        "customer_name": "Dana Whitfield",
        "documents": [
          {
            "content_type": "image/png",
            "created_at": "2026-01-01T12:00:00.000Z",
            "document_type": "customer_order_history",
            "filename": "customer-order-history.png",
            "id": "file_xxxxxxxxxxxxxx",
            "multipart_upload_urls": [
              {
                "part_number": 1,
                "url": "https://whop-assets-example.s3.amazonaws.com/uploads/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/application.pdf"
              }
            ],
            "object": "file",
            "size": 1024,
            "upload_status": "ready",
            "url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "visibility": "public"
          }
        ],
        "notes": "Two-day ceramic coating completed and collected. Before and after photos attached.",
        "product_description": "Two-stage paint correction with a three-year ceramic coating.",
        "refund_policy_attachment": {
          "content_type": "image/png",
          "filename": "booking-confirmation-email.png",
          "id": "file_xxxxxxxxxxxxxx",
          "url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        },
        "refund_policy_disclosure": "Linked from the booking page and accepted at checkout.",
        "refund_refusal_explanation": "Work was completed and the vehicle collected, so the deposit is non-refundable.",
        "service_date": "2026-01-01",
        "uncategorized_attachment": {
          "content_type": "image/png",
          "filename": "booking-confirmation-email.png",
          "id": "file_xxxxxxxxxxxxxx",
          "url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        }
      },
      "evidence_due_at": "2026-01-01T12:00:00.000Z",
      "evidence_locked_reason": "submitted",
      "evidence_submitted_at": "2026-01-01T12:00:00.000Z",
      "id": "dspt_xxxxxxxxxxxxxx",
      "issuer_comments": [
        {
          "received_at": "2026-01-01T12:00:00.000Z",
          "text": "Note: Cardholder states the ceramic coating appointment never took place\nCancellation method: By phone"
        }
      ],
      "line_items": [
        {
          "id": "li_xxxxxxxxxxxxxx",
          "label": "Ceramic Coating Package",
          "plan_id": "plan_xxxxxxxxxxxxxx",
          "plan_title": "Ceramic Coating — Full Vehicle",
          "product_id": "prod_xxxxxxxxxxxxxx",
          "product_title": "Ceramic Coating Package",
          "quantity": 1,
          "subtotal": {
            "amount": "-2.50",
            "currency": "usd",
            "decimals": 2,
            "display_decimals": 2
          }
        }
      ],
      "payment": {
        "amount": 249,
        "card_brand": "visa",
        "card_last4": "4242",
        "created_at": "2026-01-01T12:00:00.000Z",
        "currency": "usd",
        "id": "pay_xxxxxxxxxxxxxx",
        "payment_instrument": {
          "card": {
            "brand": "visa",
            "exp_month": 10,
            "exp_year": 2031,
            "issuer_identification_number": "41111111",
            "last4": "4242"
          },
          "display_name": "Visa •••• 4242",
          "icons": {
            "card": {
              "dark": {
                "png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
                "png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
                "png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
                "svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
              },
              "light": {
                "png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
                "png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
                "png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
                "svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
              }
            },
            "square": {
              "dark": {
                "png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
                "png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
                "png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
                "svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
              },
              "light": {
                "png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
                "png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
                "png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
                "svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
              }
            }
          },
          "payment_method_type": "card"
        },
        "payment_method_type": "card"
      },
      "plan_id": "plan_xxxxxxxxxxxxxx",
      "product_id": "prod_xxxxxxxxxxxxxx",
      "reason": "other",
      "reason_code": "13.1",
      "status": "under_review",
      "updated_at": "2026-01-01T12:00:00.000Z"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes