Search & list Disputes

Search and list disputes in your workspace. Use the available filters to narrow results by status, payment, provider, date range, and more.

Query Params
string

Filter for a list of disputes by ID.

string

Filter for a list of disputes by provider ID.

string

Filter for a list of disputes by provider config ID.

string

Filter for a list of disputes by provider reference.

string

Filter for a list of disputes by payment ID.

string

Filter for a list of disputes by payment provider reference.

string

Filter for a list of disputes by holder reference.

string

Filter for a list of disputes by stage.

string

Filter for a list of disputes by defense status.

string

Filter for a list of disputes by chargeback status.

string

Filter for a list of disputes by the channel the customer used to raise them.

string

Filter for a list of disputes by assigned to user email.

date-time

Filter for a list of disputes by defense period expiration date.

string

Filter for a list of disputes by reason.

string

Filter for a list of disputes by reason code.

string

Filter for a list of disputes by provider created at date. Accepts ISO 8601 date-time values or range expressions (e.g. [2024-01-01T00:00:00Z,2024-12-31T23:59:59Z)).

string

Filter for a list of disputes by merchant reference.

string

Filter for a list of disputes by execution ID.

string

Filter disputes by attached tag slugs. Accepts a comma-separated list of tag slugs (e.g. fraud,bin_list). Only disputes that have all of the specified tags attached are returned.

string
enum

Order the list by defense deadline. asc returns the soonest-expiring disputes first, desc the furthest out; disputes with no deadline are returned last either way.

Exactly one sort[field] parameter may be given per request: a second one, a repeated one, a bare sort=field, or a direction other than asc or desc all return 400.

The last link resolves in either direction, and the page it returns is the one holding the disputes with no deadline.

Allowed:
string
enum

Order the list by the date the provider raised the dispute. This is the default ordering, descending, when no sort[field] parameter is given. Disputes with no such date are returned last either way.

The one-term limit and the last link behaviour apply here too, as described on sort[defensePeriodExpiresAt].

Allowed:
boolean
Defaults to false

Boolean indicating if the disputes summary should be included in the response.

boolean
Defaults to false

Boolean indicating if the disputes payment should be included in the response.

boolean
Defaults to false

Boolean indicating if the disputes instrument should be included in the response.

boolean
Defaults to false

Boolean indicating if the representment plan status should be included in the response.

boolean
Defaults to false

Boolean indicating if the assigned user email and username should be included in the response.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Choose an example:
application/json