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. Inquiries match only the warning_ statuses. 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-25

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

Changed in 12 of the 74 revisions of this API.1727164

  • 86b97292852d33See the full diff
    • ●

      added the new warning_closed enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new warning_needs_response enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new warning_under_review enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the enum value warning_closed to the property items/ of the query request parameter status

      request-parameter-property-enum-value-added

    • ○

      added the enum value warning_needs_response to the property items/ of the query request parameter status

      request-parameter-property-enum-value-added

    • ○

      added the enum value warning_under_review to the property items/ of the query request parameter status

      request-parameter-property-enum-value-added

  • 140d015b99664316See the full diff
    • ▲

      the // response's property type changed from no type to object for status

      response-property-type-changed

    • ▲

      the // response's property type changed from no type to object for status

      response-property-type-changed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ●

      added the new cancellation_policy enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new customer_communication enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new terms_of_service enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ○

      removed subschema #2 from the // response property oneOf list for the response status

      response-property-one-of-removed

    • ○

      removed subschema #2 from the // response property oneOf list for the response status

      response-property-one-of-removed

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

    • ○

      added the required property /// to the response with the status

      response-required-property-added

  • ff3a7657356312See the full diff
    • ▲

      for the query request parameter first, default value 20 was added

      request-parameter-default-value-added

    • ●

      for the query request parameter first, the max was set to 100.00

      request-parameter-max-set

    • ●

      for the query request parameter last, the max was set to 100.00

      request-parameter-max-set

  • 2a25564a92d51See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 18cde81b67631See the full diff
    • ○

      added the required property ///////////////// to the response with the status

      response-required-property-added

  • e91d507bda4510See the full diff
    • ○

      added the optional property ///// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///// to the response with the status

      response-optional-property-added

    • ○

      added the required property ///// to the response with the status

      response-required-property-added

    • ○

      added the required property ///// to the response with the status

      response-required-property-added

    • ○

      added the required property ///// to the response with the status

      response-required-property-added

    • ○

      added the required property ///// to the response with the status

      response-required-property-added

    • ○

      added the required property ///// to the response with the status

      response-required-property-added

  • 6a23760847c81See the full diff
    • ○

      added the required property /// to the response with the status

      response-required-property-added

  • 23dfbe1a0d1f1See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • f67a043e31901See the full diff
    • ○

      added the required property /////// to the response with the status

      response-required-property-added

  • f1020c3ecda43See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.