List transactions
Transactions
List Transactions
Retrieve a paginated list of transactions for your account.
GET
List transactions
Retrieve and filter your full transaction history. Results include an aggregate overview independent of pagination.
Counts respect all query filters (
Overview object
Every list response includes anoverview with counts for the full filtered set — not just the current page:
status, type, from, to, channelId, amountMin, amountMax, q) but ignore cursor — the numbers stay consistent across pages.
Transaction fee field
Each transaction item includes atransactionFee field (merchant API) / transaction_fee field (developer API):
The fee is
0 when no pricing rule is configured for your account.
Pagination
Transactions return newest first. PassnextCursor from the previous response to fetch the next page.
nextCursor: null means you have reached the last page.
Filtering
Combinestatus and type to narrow results:
Authorizations
Paste your PalPluss API key in the username field and leave the password field empty — it is ignored.
Get your key from console → Settings → API Keys (starts with pk_live_ or pk_test_).
In your own code, send the key directly:
Authorization: Basic YOUR_API_KEY
Query Parameters
Number of records per page (1–100, default 20).
Required range:
1 <= x <= 100Pagination cursor from the previous response nextCursor field.
Filter by transaction status.
PENDING— Awaiting customer action or provider responsePROCESSING— Provider accepted; waiting for final confirmationSUCCESS— Completed successfullyFAILED— Transaction failed (provider declined or timeout)REVERSED— Successfully reversed (wallet credited back)CANCELLED— Cancelled before processing
Available options:
PENDING, PROCESSING, SUCCESS, FAILED, REVERSED, CANCELLED Filter by transaction type.
STK— M-Pesa STK Push collectionB2C— Business to Customer payout
Available options:
STK, B2C