Skip to main content
GET
/
v1
/
accounts
/
{account_id}
/
deposit-instructions
List Deposit Instructions
curl --request GET \
  --url https://api.hopnow.io/v1/accounts/{account_id}/deposit-instructions \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "object": "<string>",
  "account_id": "<string>",
  "currency": "<string>",
  "recon_strategy": "<string>",
  "status": "<string>",
  "beneficiary_name": "<string>",
  "beneficiary_address": "<string>",
  "bank_name": "<string>",
  "bank_address": "<string>",
  "account_name": "<string>",
  "account_number": "<string>",
  "iban": "<string>",
  "swift_bic": "<string>",
  "routing_number": "<string>",
  "sort_code": "<string>",
  "memo": "<string>",
  "supported_rails": [
    {}
  ],
  "created": "<string>",
  "updated": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://apidocs.hopnow.io/llms.txt

Use this file to discover all available pages before exploring further.

Deposit instructions are for fiat currencies only (e.g., USD, EUR, GBP, JPY, HKD). To receive crypto deposits, use the Wallets API instead. Fiat currencies must be enabled for your account — if a currency returns "status": "unavailable", contact support to enable it. See the Deposit Flows guide for a complete overview.

​
Path Parameters

​
account_id
string
required
The account’s external ID (starts with acc_)

​
Response

Returns an array of deposit instruction objects.
​
id
string
Deposit instruction identifier
​
object
string
Always returns "deposit_instruction"
​
account_id
string
Parent account ID
​
currency
string
ISO 4217 currency code (e.g., USD, EUR, GBP)
​
recon_strategy
string
Reconciliation strategy: virtual_account or memo_reference
​
status
string
Status: active or revoked
​
beneficiary_name
string
Name of the beneficiary for the deposit (who the sender should address the payment to)
​
beneficiary_address
string
Address of the beneficiary
​
bank_name
string
Name of the receiving bank
​
bank_address
string
Address of the receiving bank
​
account_name
string
Name on the bank account
​
account_number
string
Bank account number
​
iban
string
International Bank Account Number
​
swift_bic
string
SWIFT/BIC code
​
routing_number
string
Bank routing number
​
sort_code
string
Sort code (UK banking)
​
memo
string
Memo or reference to include with transfers (for memo_reference strategy)
​
supported_rails
array
Supported payment rails (e.g., ach, fedwire, swift, sepa, spei)
​
created
string
ISO 8601 timestamp when created
​
updated
string
ISO 8601 timestamp when last updated

​
Response Example

[
  {
    "id": "hba_1234567890abcdef",
    "object": "deposit_instruction",
    "account_id": "acc_1234567890abcdef",
    "currency": "USD",
    "recon_strategy": "virtual_account",
    "status": "active",
    "beneficiary_name": "Hop Innovations Inc",
    "beneficiary_address": "123 Main St, New York, NY 10001",
    "bank_name": "Partner Bank",
    "bank_address": "456 Wall St, New York, NY 10005",
    "account_name": "Hop Innovations Inc",
    "account_number": "1234567890",
    "iban": null,
    "swift_bic": "CHASUS33",
    "routing_number": "021000021",
    "sort_code": null,
    "memo": null,
    "supported_rails": ["ach", "fedwire"],
    "created": "2024-01-01T00:00:00Z",
    "updated": "2024-01-01T00:00:00Z"
  },
  {
    "id": "hba_fedcba0987654321",
    "object": "deposit_instruction",
    "account_id": "acc_1234567890abcdef",
    "currency": "EUR",
    "recon_strategy": "memo_reference",
    "status": "active",
    "beneficiary_name": "Hop Innovations Inc",
    "beneficiary_address": "123 Main St, New York, NY 10001",
    "bank_name": "European Partner Bank",
    "bank_address": "1 Bank Platz, Frankfurt, Germany",
    "account_name": "Hop Innovations Inc",
    "account_number": null,
    "iban": "DE89370400440532013000",
    "swift_bic": "DEUTDEFFXXX",
    "routing_number": null,
    "sort_code": null,
    "memo": "REF-ACC123",
    "supported_rails": ["sepa", "swift"],
    "created": "2024-01-01T00:00:00Z",
    "updated": "2024-01-01T00:00:00Z"
  }
]