Skip to main content
GET
Get Funding Instructions
Returns the deposit (funding) instructions for an account — how to fund each of its currencies. Each entry is either fiat bank transfer details (NGN, USD, …) or a crypto deposit address. Any USD account still being provisioned by the provider is surfaced under pending. A client can hold several USD accounts, one per reference — each appears as its own entry, carrying the reference and label it was issued with, so you can hand the right details to the right source. Both are null on the client’s primary account.
Deposit accounts are provisioned once an account’s application is approved. Issue them with Issue Bank Account; they then appear here. You can also receive an account.virtual_account.created webhook when one is added.

Example Request

Example Response

Query Parameters

pending is only populated when currency is omitted or USD; it is empty once the USD account is live.

Authorizations

X-API-Key
string
header
required

Your Rolla API key

Path Parameters

accountId
string<uuid>
required

Identifier of an account owned by the same user as your API key's business

Example:

"eec3cbed-79d8-4370-87a0-b6be9e287337"

Query Parameters

currency
string

Scope to a single currency (e.g. NGN, USD, USDC). Omit to return every funded currency.

Required string length: 2 - 10
Example:

"USD"

Response

Funding instructions retrieved

status
integer
required
Example:

200

message
string
required
Example:

"Funding instructions retrieved successfully"

success
boolean
required
Example:

true

data
object
required