GET/v1/transactions

List transactions

Returns a paginated list of transactions for your merchant account.

Authentication

Secret Key — send Authorization: Bearer YOUR_KEY header.

Query parameters

Parameter	Type	Required	Description
`type`	string	No	payment \| refund \| payout
`status`	string	No	pending \| completed \| failed
`currency`	string	No	USD \| ZWG
`from_date`	string	No	ISO 8601 start date
`to_date`	string	No	ISO 8601 end date
`gateway`	string	No	Filter by gateway name
`search`	string	No	Search reference or customer
`cursor`	string	No	Pagination cursor
`limit`	integer	No	Page size (default 25, max 100)

Response fields

Field	Type	Description
`items`	array	Array of transaction objects
`next_cursor`	string \| null	Cursor for next page
`has_more`	boolean	Whether more results exist

Code examples

bash

curl https://api.watenga.africa/v1/transactions?limit=25&status=completed \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response example

json

{
  "success": true,
  "data": {
    "items": [{ "id": "txn_01HQXYZ", "status": "completed", "amount": "25.00", "currency": "USD" }],
    "next_cursor": "cursor_abc",
    "has_more": false
  }
}