Get bill payments history
This document shows you how to retrieve a history of all purchased bill services including commission earned
Last updated 13 September 2026
https://api.flutterwave.com/v3/bills/history
authorization string required
Pass your secret key as a bearer token in the request header to authorize this call
FILL IN ALL REQUIRED FIELDS
status string
The transaction status Allowed values: Successful, Failed, Reversed.
from string
This is the start date it can be in any of this formats: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD
to string
This is the end date, it can be in any of this formats: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD
page string
The page index to start the search from.
limit string
The number of entries returned per page.
reference string
This unique identifier for a single payment.
batch_reference string
This unique identifier for a bulk payment.
category string
The bill category code.
country string
This is the country of the Biller. Allowed values: NG, GH, KE, ZM.
FILL IN ALL REQUIRED FIELDS
status string
message string
meta object
FILL IN ALL REQUIRED FIELDS
page_info object
FILL IN ALL REQUIRED FIELDS
total integer
total_pages integer
current_page integer
data array of objects
FILL IN ALL REQUIRED FIELDS
id integer
currency string
customer_id string
frequency string
amount string
category string
recurring_payment_id string
product string
product_name string
commission string
transaction_date string
tx_id integer
customer_reference string
country string
flw_ref string
tx_ref string
batch_id integer
extra string
product_details string
status string
Shell