Skip to main content
GET
List transfers

Overview

Lists all merchant-initiated transfers for the authenticated merchant with optional filtering and pagination.

Authentication

X-Api-Key
string
required
Your merchant API key

Query Parameters

limit
integer
Number of results per page (default: 20, max: 100)
page
integer
Page number (default: 1)
status
string
Filter by external statusAllowed values: PROCESSING | SETTLED | FAILED
currency
string
Filter by transfer currencyAllowed values: NGN | USD

Request Example

Response

data
array
required
Array of transfer objects
page
integer
required
Current page number
limit
integer
required
Results per page
total
integer
required
Total number of transfers
total_pages
integer
required
Total number of pages