Skip to main content
GET
List disputes
List disputes with filtering and pagination

Authorizations

Authorization
string
header
required

Bearer API Key authentication. Format: Authorization: Bearer {your_api_key}

Headers

Request-Id
string
default:008e3967-a1b5-48bb-be14-d5bff5092e61
required

The unique identifier of the request

Query Parameters

ids
string[]

Filter by Subotiz dispute IDs

channel_dispute_ids
string[]

Filter by channel dispute IDs

order_ids
string[]

Filter by order IDs

dispute_status
string[]

Dispute status filter, comma separated values, e.g. needs_response,under_review

payment_channel
string[]

Payment channel filter, comma separated values

dispute_reason
string[]

Dispute reason filter, comma separated values

starting_after
string

Cursor for pagination: starting_after

ending_before
string

Cursor for pagination: ending_before

limit
integer<int32>

Page size, default 10, range [1,100]

merchant_id
string

Merchant ID

created_at.gt
string

Minimum value to filter by (exclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')

created_at.gte
string

Minimum value to filter by (inclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')

created_at.lt
string

Maximum value to filter by (exclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')

created_at.lte
string

Maximum value to filter by (inclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')

updated_at.gt
string

Minimum value to filter by (exclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')

updated_at.gte
string

Minimum value to filter by (inclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')

updated_at.lt
string

Maximum value to filter by (exclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')

updated_at.lte
string

Maximum value to filter by (inclusive, UTC time in RFC3339 format, such as '2025-01-01T00:00:00Z')

Response

OK

code
string

error code

message
string

error message

data
object