Skip to main content
GET
List virtual account deposits

Overview

Retrieve payments received into USD and EUR bank details created with /v1/virtual-accounts. All virtual account deposits settle in USD. For a EUR-funded deposit, source_amount, source_currency, and fx_rate identify the original EUR payment and its conversion.
Use List deposits for NGN and crypto deposits received through funding accounts.

Authentication

string
required
Your merchant API key

Query Parameters

string
Filter by customer ID (UUID).
string
Filter by virtual account ID in UUID format.
string
Filter by virtual account deposit status.Allowed values: PENDING | COMPLETED | FLAGGED | FAILED
string
Filter deposits created from this time (RFC 3339, inclusive).
string
Filter deposits created before this time (RFC 3339, exclusive).
integer
Results per page.Default: 50 | Max: 200
integer
Page number to retrieve.Default: 1

Request Examples

Response

array
required
Array of virtual account deposit objects.
integer
required
Current page number.
integer
required
Results per page.
integer
required
Total number of deposits matching filters.
integer
required
Total number of pages available.

Success Response

Next steps

Get Virtual Account Deposit

Get a specific virtual account deposit by ID

USD and EUR Virtual Accounts

Learn how virtual accounts work