public.funding-accounts
List Funding Accounts
Lists funding accounts for the authenticated merchant with optional filtering and pagination. Provider-backed instructions include provider_availability with the provider's current service state.
get/v1/funding-accounts
Query parameters
limitinteger
Number of results per page (default: 50, max: 200)
pageinteger
Page number (default: 1)
customer_idstring
Filter by customer ID
type'TEMPORARY' | 'PERMANENT'
Filter by funding account type
rail'NGN_VIRTUAL_ACCOUNT' | 'CRYPTO_ADDRESS'
Filter by rail
status'PENDING' | 'ACTIVE' | 'FAILED' | 'DISABLED'
Filter by status
account_numberstring
Filter by active NGN virtual account number
addressstring
Filter by active crypto receive address
Response
OK
Example response
{
"data": [
{
"amount": "50000.75",
"asset": "USDC",
"chain": "BASE",
"created_at": "2026-01-05T15:04:05Z",
"currency": "NGN",
"customer_id": "650e8400-e29b-41d4-a716-446655440000",
"developer_fee": {
"percentage": "1.5"
},
"disabled_at": "2026-01-05T16:04:05Z",
"expires_at": "2026-01-05T16:04:05Z",
"failure_code": "PROVISIONING_FAILED",
"failure_message": "virtual account provisioning failed",
"id": "750e8400-e29b-41d4-a716-446655440000",
"instructions": [
{
"account_name": "Daya-John Doe",
"account_number": "1234567890",
"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"bank_code": "035",
"bank_name": "Wema Bank",
"chain": "BASE",
"currency": "NGN",
"expires_at": "2026-01-05T16:04:05Z",
"failure": {
"code": "ACCOUNT_NAME_MISMATCH",
"message": "The bank account name does not match the customer's verified identity."
},
"provider": "FLUTTERWAVE",
"provider_availability": {
"message": "This provider is experiencing funding-account delays.",
"status": "DEGRADED"
},
"status": "ACTIVE",
"type": "NGN_VIRTUAL_ACCOUNT"
}
],
"object": "funding_account",
"rail": "NGN_VIRTUAL_ACCOUNT",
"settlement_destination": {
"destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"destination_asset": "USDC",
"destination_bank": {
"account_name": "Jane Doe",
"account_number": "0123456789",
"bank_code": "058"
},
"destination_chain": "BASE",
"destination_currency": "NGN",
"expires_at": "2026-01-05T16:04:05Z",
"rate_id": "550e8400-e29b-41d4-a716-446655440000",
"type": "INTERNAL_BALANCE"
},
"status": "ACTIVE",
"type": "TEMPORARY",
"updated_at": "2026-01-05T15:04:05Z"
}
]
}Changes
No recorded changes to this endpoint across all 1 revision of this API.