Lists the disputes (chargebacks) raised against your business's payments, newest first by the date each dispute was raised.

Each item is the disputed Payment object with the dispute fields added: dispute_status, dispute_reason, dispute_amount, dispute_currency, dispute_date, and deadline_to_respond. dispute_status is one of needs_response, under_review, won, lost, expired, closed, resolved, or withdrawn.

Results are paginated: 20 disputes per page by default, up to 1000 with per_page. The response's pagination_meta tells you whether more pages exist; see Pagination for how to fetch every page.

To be told when a dispute opens or changes, subscribe to the dispute.* events with Create webhook.