Get all transfers

get

https://api.flutterwave.com/v3/transfers

Fetch all transfers on your account

Query Params

reference

string

Defaults to ref-abc123

The merchant's unique reference for the transfer.

page

string

Defaults to 1

This allows you fetch from a specific page e.g. setting 1 retrieves the first page.

status

string

Defaults to successful

This allows you fetch only transfers with a specific status e.g. fetch all successful transactions. Expected values include failed, successful.

from

string

Defaults to 2023-11-18

This is the start date for the query.

string

Defaults to 2024-08-24

This is the end date for the query.

include_proof

boolean

Defaults to false

This flags adds the proof (session id) of the transfer to the response.

include_provider_ref

boolean

Defaults to false

This flag include the provider reference for the transfer in the response.

include_approver_info

boolean

Defaults to false

This flag adds the approval information for the transfers to the response.

include_vat

boolean

Defaults to false

This flag includes the transfers' VAT information in the response.

include_date_completed

boolean

Defaults to false

This flag adds the completion date for the transfers to the response.

include_rate

boolean

Defaults to false

This flag include the FX rate used for the transfer in the response.

include_debit_currency_amount

boolean

Defaults to false

This flag include the debit currency for the transfer in the response.

page_size

string

Defaults to 10

The number of query results to return per page. If unspecified, this would default to 10 items per page.

Headers

Authorization

string

required

Defaults to Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X

Pass your secret key as a bearer token in the request header to authorize this call

Responses

200200

400400