Retrieve banking details
GET/v1/baas/virtual-accounts/banking-details/:walletId
This endpoint returns the banking details for deposit instructions related to a specified wallet.
Transfer Types:
- SWIFT: International wire transfers
- ACH: US domestic ACH transfers (requires dedicated account number)
- FEDWIRE: US domestic wire transfers (works with or without dedicated account number)
Note: ACH transfers require a dedicated account number to be assigned to the wallet first. For accounts without a dedicated account number, FedWire returns a reference field with the beneficiary account number.
Request
Path Parameters
Query Parameters
Possible values: [SWIFT, ACH, FEDWIRE]
Type of banking details to retrieve (defaults to SWIFT if not provided)
Responses
- 200
- 400
- 403
- 404
Banking details retrieved with success.
- application/json
- Schema
- Example (from schema)
Schema
data
object
beneficiary
object
required
Beneficiary information
Beneficiary name
Beneficiary address
Account number (may be absent if dedicated account number is not available)
beneficiary_bank
object
required
Beneficiary bank information
Bank name
SWIFT BIC code (for SWIFT transfers)
ABA/Routing number (for ACH and FedWire transfers)
Bank address
intermediary_bank
object
required
Intermediary bank information
Intermediary bank name
Routing number
BIC code
{
"traceId": "string",
"message": "string",
"data": {
"beneficiary": {
"name": "John Doe",
"address": "123 Main St, San Juan, PR 00918",
"account_number": "256783259046169"
},
"beneficiary_bank": {
"name": "Zenus Bank International Inc",
"swift": "ZEITPRSJXXX",
"routing_number": "021000021",
"bank_address": "Zenus Tower, 19th Floor, 252 Ponce de Leon, San Juan, PR, 00918"
},
"intermediary_bank": {
"name": "JP Morgan Chase NA, New York NY, US",
"routing_number": "021000021",
"bic_code": "CHASUS33"
}
}
}
Invalid request payload. This can happen if required fields are missing or have invalid formats.
- application/json
- Schema
- Example (from schema)
Schema
{
"traceId": "string",
"message": "string"
}
The API key is invalid or the client does not have sufficient permissions.
- application/json
- Schema
- Example (from schema)
Schema
{
"traceId": "string",
"message": "string"
}
One of the specified resources was not found. Does not apply for empty result set.
- application/json
- Schema
- Example (from schema)
Schema
{
"traceId": "string",
"message": "string"
}