---
title: "Changes to List Disputes"
method: GET
path: "/disputes"
---

# Changes to List Disputes

`GET /disputes`

> Every recorded change to this endpoint, newest first.
> 74 revisions in range; 1 not diffed.

## Timeline

Changed in 12 of 74 revisions.

- **2026-09-25** `86b97292852d` — 3 warning, 3 info
- **2026-09-23** `140d015b9966` — 4 breaking, 3 warning, 16 info
- **2026-09-16** `ff3a76573563` — 1 breaking, 2 warning
- **2026-09-10** `2a25564a92d5` — 1 info
- **2026-09-09** `18cde81b6763` — 1 info
- **2026-08-24** `e91d507bda45` — 10 info
- **2026-08-20** `6a23760847c8` — 1 info
- **2026-08-19** `23dfbe1a0d1f` — 1 info
- **2026-08-18** `f67a043e3190` — 1 info
- **2026-08-07** `f1020c3ecda4` — 3 info
- **2026-07-31** `099fdc3be422` — 1 info
- **2026-07-26** `60bbb4a6ffbc` — 12 breaking, 19 warning, 126 info

## Changes

- **2026-09-25** `86b97292852d` — 3 warning, 3 info
  - added the new `warning_closed` enum value to the `data/items/status` response property for the response status `200`
  - added the new `warning_needs_response` enum value to the `data/items/status` response property for the response status `200`
  - added the new `warning_under_review` enum value to the `data/items/status` response property for the response status `200`
  - added the enum value `warning_closed` to the property `items/` of the `query` request parameter `status`
  - added the enum value `warning_needs_response` to the property `items/` of the `query` request parameter `status`
  - added the enum value `warning_under_review` to the property `items/` of the `query` request parameter `status`
- **2026-09-23** `140d015b9966` — 4 breaking, 3 warning, 16 info
  - the `data/items/buyer` response's property type changed from no type to `object` for status `200`
  - the `data/items/payment` response's property type changed from no type to `object` for status `200`
  - removed the required property `data/items/generated_response_attachment` from the response with the `200` status
  - removed the required property `data/items/rapid_dispute_resolution` from the response with the `200` status
  - added the new `cancellation_policy` enum value to the `data/items/evidence/documents/items/document_type` response property for the response status `200`
  - added the new `customer_communication` enum value to the `data/items/evidence/documents/items/document_type` response property for the response status `200`
  - added the new `terms_of_service` enum value to the `data/items/evidence/documents/items/document_type` response property for the response status `200`
  - removed `#/components/schemas/DisputeBuyer, subschema #2` from the `data/items/buyer` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/DisputePayment, subschema #2` from the `data/items/payment` response property `oneOf` list for the response status `200`
  - added the required property `data/items/buyer/email` to the response with the `200` status
  - added the required property `data/items/buyer/member_id` to the response with the `200` status
  - added the required property `data/items/buyer/name` to the response with the `200` status
  - added the required property `data/items/buyer/user_id` to the response with the `200` status
  - added the required property `data/items/buyer/username` to the response with the `200` status
  - added the required property `data/items/payment/amount` to the response with the `200` status
  - added the required property `data/items/payment/card_brand` to the response with the `200` status
  - added the required property `data/items/payment/card_last4` to the response with the `200` status
  - added the required property `data/items/payment/created_at` to the response with the `200` status
  - added the required property `data/items/payment/currency` to the response with the `200` status
  - added the required property `data/items/payment/id` to the response with the `200` status
  - added the required property `data/items/payment/payment_instrument` to the response with the `200` status
  - added the required property `data/items/payment/payment_method_type` to the response with the `200` status
  - added the required property `data/items/payment/payment_processor` to the response with the `200` status
- **2026-09-16** `ff3a76573563` — 1 breaking, 2 warning
  - for the `query` request parameter `first`, default value `20` was added
  - for the `query` request parameter `first`, the max was set to `100.00`
  - for the `query` request parameter `last`, the max was set to `100.00`
- **2026-09-10** `2a25564a92d5` — 1 info
  - added the required property `data/items/line_items` to the response with the `200` status
- **2026-09-09** `18cde81b6763` — 1 info
  - added the required property `data/items/payment/oneOf[#/components/schemas/DisputePayment]/payment_instrument/oneOf[#/components/schemas/PaymentInstrument]/card/oneOf[#/components/schemas/PaymentInstrumentCard]/issuer_identification_number` to the response with the `200` status
- **2026-08-24** `e91d507bda45` — 10 info
  - added the optional property `data/items/evidence/documents/items/multipart_chunk_size` to the response with the `200` status
  - added the optional property `data/items/evidence/documents/items/multipart_upload_id` to the response with the `200` status
  - added the optional property `data/items/evidence/documents/items/multipart_upload_urls` to the response with the `200` status
  - added the optional property `data/items/evidence/documents/items/upload_headers` to the response with the `200` status
  - added the optional property `data/items/evidence/documents/items/upload_url` to the response with the `200` status
  - added the required property `data/items/evidence/documents/items/created_at` to the response with the `200` status
  - added the required property `data/items/evidence/documents/items/object` to the response with the `200` status
  - added the required property `data/items/evidence/documents/items/size` to the response with the `200` status
  - added the required property `data/items/evidence/documents/items/upload_status` to the response with the `200` status
  - added the required property `data/items/evidence/documents/items/visibility` to the response with the `200` status
- **2026-08-20** `6a23760847c8` — 1 info
  - added the required property `data/items/evidence/documents` to the response with the `200` status
- **2026-08-19** `23dfbe1a0d1f` — 1 info
  - added the required property `data/items/generated_response_attachment` to the response with the `200` status
- **2026-08-18** `f67a043e3190` — 1 info
  - added the required property `data/items/payment/oneOf[#/components/schemas/DisputePayment]/payment_instrument` to the response with the `200` status
- **2026-08-07** `f1020c3ecda4` — 3 info
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/code` to the response with the `401` status
  - added the optional property `error/code` to the response with the `403` status
- **2026-07-31** `099fdc3be422` — 1 info
  - added the required property `data/items/issuer_comments` to the response with the `200` status
- **2026-07-26** `60bbb4a6ffbc` — 12 breaking, 19 warning, 126 info
  - the `query` request parameter `direction` was restricted to a list of enum values
  - for the `query` request parameter `direction`, default value `desc` was added
  - added `#/components/schemas/DisputePayment, subschema #2` to the `data/items/payment` response property `oneOf` list for the response status `200`
  - the `data/items/created_at` response's property type changed from `string, null` to `string`, and format from `date-time` to no format for status `200`
  - the `data/items/payment` response's property type changed from `object, null` to no type for status `200`
  - removed the required property `data/items/company` from the response with the `200` status
  - removed the required property `data/items/editable` from the response with the `200` status
  - removed the required property `data/items/needs_response_by` from the response with the `200` status
  - removed the required property `data/items/payment/id` from the response with the `200` status
  - removed the required property `data/items/plan` from the response with the `200` status
  - removed the required property `data/items/product` from the response with the `200` status
  - removed the required property `data/items/visa_rdr` from the response with the `200` status
  - deleted the `query` request parameter `company_id`
  - removed the optional property `error/code` from the response with the `400` status
  - removed the optional property `error/code` from the response with the `401` status
  - removed the optional property `error/code` from the response with the `403` status
  - removed the optional property `error/param` from the response with the `400` status
  - removed the optional property `error/param` from the response with the `401` status
  - removed the optional property `error/param` from the response with the `403` status
  - added the new `bank_cannot_process` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `credit_not_processed` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `declined_authorization` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `documentation_request` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `duplicate` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `fraudulent` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `other` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `processing_error` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `product_not_received` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `product_unacceptable` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `subscription_canceled` enum value to the `data/items/reason` response property for the response status `200`
  - added the new `unrecognized` enum value to the `data/items/reason` response property for the response status `200`
  - api operation id `listDispute` removed and replaced with `listDisputes`
  - the security scope `access_pass:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `company:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `payment:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `plan:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - added the new optional `header` request parameter `Api-Version-Date`
  - added the new optional `query` request parameter `account_id`
  - added the new optional `query` request parameter `currency`
  - added the new optional `query` request parameter `order`
  - …117 more

---

[Operation](https://skmtc.dev/whop/apis/whop-api/docs/disputes/get.md) · [API](https://skmtc.dev/whop/apis/whop-api.md) · [Page](https://skmtc.dev/whop/apis/whop-api/changes/disputes/get)
