Retrieve a dispute
GET /disputes/{id}: fetch a single dispute by id, with its message thread.
GET
https://api.wajub.com/disputes/{id}Private key required
Dispute endpoints take a private (sk.…) or restricted key, in live and in sandbox. A public key
gets a 406.
The response carries the dispute and its messages thread. A field with no value is left out.
GET
https://api.wajub.com/disputes/{id}curl https://api.wajub.com/disputes/dsp_hrgUOE225KMKULRQqYvl \
-H "Authorization: sk.xxxxxxxxxxxxxxxx…"{
"code": 200,
"status": "OK",
"message": "Dispute retrieved",
"dispute": {
"id": "dsp_hrgUOE225KMKULRQqYvl",
"transaction": "trx_CSUGajfv9xh0XQ5wu2lx",
"customer": "cus_Qe7Tb2Wn5Lr9Xc4Mv8Hk1Zs3",
"amount": 5000,
"currency": "XAF",
"status": "open",
"reason": "fraudulent",
"evidence": [
],
"evidence_details": [
],
"metadata": [
],
"sandbox": false,
"due_date": "2026-07-22T10:21:08+00:00",
"evidence_reaches_provider": false,
"created_at": "2026-07-15T10:21:08+00:00",
"updated_at": "2026-07-15T10:21:08+00:00",
"messages": [
]
}
}
idstringfacultatifUnique dispute identifier:
dsp_ followed by 20 characters, dsp_test_ in sandbox.transactionstringfacultatifThe disputed payment
id.customerstring?facultatifThe customer
id.amountnumberfacultatifThe disputed amount, in the major unit of the currency. It can be less than the payment.
statusenumfacultatifopen, under_review, resolved, won or lost.reasonstringfacultatifReason given by the customer or the provider.
merchant_responsestring?facultatifYour response, set when you accept or close the dispute.
evidenceobjectfacultatifThe evidence you submitted, keyed by
evidence_type. A piece with a file carries file_path, file_name, uploaded_at and url, a signed link to the private file, valid 30 minutes.evidence_reaches_providerbooleanfacultatiffalse when the evidence is only recorded at Wajub and not forwarded to the provider. No provider receives it yet.due_datedatetime?facultatifDeadline to answer by: the provider's on a chargeback when it sends one, seven days after the opening otherwise, a dispute opened from Pocket included.
resolved_atdatetime?facultatifWhen the dispute was won, lost or resolved.
messagesarrayfacultatifThe thread:
id, sender_type, sender_id, content, attachments, created_at. Each attachment carries a url, a signed link valid 30 minutes. A webhook carries the same dispute without these links.