List disputes
GET /disputes: list the disputes on your account.
GET
https://api.wajub.com/disputesPrivate key required
Dispute endpoints take a private (sk.…) or restricted key, in live and in sandbox. A public key
gets a 406.
statusstringoptionalFilter:
open, under_review, resolved, won or lost.date_fromstringoptionalCreated on or after this date (YYYY-MM-DD).
date_tostringoptionalCreated on or before this date, on or after
date_from.searchstringoptionalSearch by id, reason or description.
per_pageintegeroptionaldefault : 25Number of items per page (1 to 100).
pageintegeroptionaldefault : 1Page number, with offset pagination: a whole number from 1, anything else is a
422.cursorstringoptionalCursor from a previous response. See [Pagination](/api/pagination).
The list comes back under items, most recent first.
GET
https://api.wajub.com/disputes?status=opencurl "https://api.wajub.com/disputes?status=open" \
-H "Authorization: sk.xxxxxxxxxxxxxxxx…"{
"code": 200,
"status": "OK",
"message": "Disputes retrieved",
"items": [
{
"id": "dsp_hrgUOE225KMKULRQqYvl",
"transaction": "trx_CSUGajfv9xh0XQ5wu2lx",
"amount": 5000,
"currency": "XAF",
"status": "open",
"reason": "fraudulent",
"due_date": "2026-07-22T10:21:08+00:00",
"created_at": "2026-07-15T10:21:08+00:00"
}
],
"meta": {
"current_page": 1,
"last_page": 1,
"per_page": 25,
"total": 1
}
}