List disputes
View disputes for your account with filters and cursor pagination.
View cases for the company and environment of your API key, with filters and sorting. Use the identifier from a result to retrieve its details.
See List disputes and navigate pages for pagination and Tracking stages to interpret the progress of each case.
Query Params
Number of disputes per page. Invalid values use the default; values above the maximum use the limit.
From 1 to 100
Cursor from page.next_after in the previous response. Keep the filters and sorting; do not send together with before.
Up to 128 characters
Cursor from page.previous_before to go back. Keep the filters and sorting; do not send together with after.
Up to 128 characters
Comma-separated case stages: open, in_analysis, refund_in_analysis, closed, cancelled, rejected or failed. Closed indicates a closed review, without confirming a favorable decision or refund.
Up to 256 characters
Filter by the linked charge using its complete public identifier. A valid ID with no accessible cases returns an empty list.
Up to 100 characters
Filter by the exact disputed amount, in Brazilian real cents. This does not represent the amount currently held.
Minimum 0
Include disputes created from this instant onward, in Unix seconds in UTC. The boundary is inclusive.
From 1 to 253402300799
Include disputes created up to this instant, in Unix seconds in UTC. The boundary is inclusive and must be equal to or later than created_gte.
From 1 to 253402300799
Field used to sort the list: creation date or disputed amount.
Ascending or descending order of the selected field.
Responses
For common errors, see HTTP response codes.