Skip to main content
GET
List Chargebacks
Use status=NEW (and PENDING_RESPONSE, INSUFFICIENT_DOCUMENT) to find chargebacks still waiting on you, or rely on the DISPUTE_UPDATED webhook to hear about each one as it is raised.

Authorizations

X-Client-ID
string
header
required

Client Application ID - Your unique application identifier used to authenticate API requests. You can find your Client ID in the Developer Settings section of the merchant dashboard.

X-Client-Secret
string
header
required

Client Secret Key - Your secret key used alongside the Client ID for secure authentication. Keep this confidential and never expose it in client-side code. Available in the Developer Settings section of the merchant dashboard.

X-API-Version
string
header
required

API Version - Specifies which version of the API to use (e.g., '1.X.X', '2.X.X', or '3.X.X'). This header allows you to control which API version your integration uses. Default version information is available in the Developer Settings.

Headers

X-Merchant-ID
string

PSPs only: list just this sub-merchant's chargebacks. Without it, a PSP sees its own and all its sub-merchants' chargebacks.

Query Parameters

status
string

Only chargebacks in this status, e.g. NEW or PENDING_DOC_REVIEW.

payment_id
string

Only chargebacks on this payment.

order_id
string

Only chargebacks on this EximPe order.

order_reference_id
string

Only chargebacks on the order with this reference of yours.

from_date
string<date>

Created on or after this date. Format: YYYY-MM-DD.

to_date
string<date>

Created up to and including this date. Format: YYYY-MM-DD.

page
integer
default:1

Page number, from 1.

page_size
integer
default:250

Results per page.

Response

200 - application/json

OK

success
boolean
message
string
data
object