Skip to main content
GET
Get Payment History
Retrieve a user’s recent bill payment transaction history. This allows users to look up previously generated meter tokens, recharge references, and tax/collection receipts.

Query Parameters

Sample Paginated Response

Authorizations

Authorization
string
header
default:sk_test_handle_master_key
required

Supply your secret API key (e.g. sk_live_... or sk_test_...) in the Authorization header.

Query Parameters

page
integer
default:1

Page number (defaults to 1)

limit
integer
default:20

Number of records per page (default 20, max 100)

category
string

Filter by VAS Category (e.g. ELECTRICITY, AIRTIME, DATA, RRR)

status
string

Filter by status (SUCCESS, PENDING, FAILED)

Search by meter number, phone, recipientId, or transaction reference

Response

200 - application/json

Paginated user transaction history

success
boolean
Example:

true

data
object