AI agents: this site is available as Markdown at /llms.txt. Each page has a Markdown version at its URL with a .md suffix, and the full API is described in /api/v3/openapi.json.

Query wallet reversals

Retrieve all wallet funding reversals and refunds.

Last updated 13 September 2026

get

https://api.flutterwave.com/v3/payout-subaccounts/refunds

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 final status of the funding reversal. Supported values are SUCCESSFUL, PENDING and FAILED.

from string
The start date of the reversal query. Expected format: YYYY-MM-DD.

to string
The end date of the reversal query. Expected format: YYYY-MM-DD.

reference string
The unique reference for the reversal.

FILL IN ALL REQUIRED FIELDS

status string

message string

data object

FILL IN ALL REQUIRED FIELDS

page_info object

FILL IN ALL REQUIRED FIELDS

total integer

current_page integer

total_pages integer

transfers array of objects

FILL IN ALL REQUIRED FIELDS

id integer

account_number string

bank_code string

fullname string

date_created string

currency string

debit_currency string

amount integer

fee integer

status string

reference string

meta array of objects

FILL IN ALL REQUIRED FIELDS

BeneficiaryCountry string

AccountNumber string

FirstName string

LastName string

BankName string

RoutingNumber string

Sender string

SenderCountry string

narration string

approver string

complete_message string

requires_approval integer

is_approved integer

bank_name string

proof string

is_retry boolean

can_retry boolean

Shell

1
1


FL.AI

Answers from the Flutterwave docs

Hi, I’m FL.AI

Ask anything about Flutterwave’s APIs, guides and coverage.

FL.AI can make mistakes. Check important details in the docs.

Get API Keys