Skip to main content
GET
List USD virtual account deposits

Overview

Retrieve payments received into USD virtual accounts. Use this endpoint when a customer pays into USD bank details created with /v1/virtual-accounts.
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 USD virtual account ID (UUID).
string
Filter by USD 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 USD 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 USD Virtual Account Deposit

Get a specific USD virtual account deposit by ID

USD Virtual Accounts

Learn how USD virtual accounts work