> ## 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.

# Get Deposit Instruction

> Retrieve deposit instructions for a specific currency

<Note>
  Deposit instructions are for **fiat currencies only** (e.g., USD, EUR, GBP, JPY, HKD). To receive crypto deposits, use the [Wallets API](/api-reference/wallets/create-wallet) instead. Fiat currencies must be enabled for your account — if a currency returns `"status": "unavailable"`, contact support to enable it. See the [Deposit Flows](/guides/deposit-flows) guide for a complete overview.
</Note>

## Path Parameters

<ParamField path="account_id" type="string" required>
  The account's external ID (starts with `acc_`)
</ParamField>

<ParamField path="currency" type="string" required>
  ISO 4217 currency code (e.g., USD, EUR, GBP)
</ParamField>

## Response

Returns a deposit instruction object when available, or an unavailability response when no instructions exist for the requested currency.

### When Available

<ResponseField name="id" type="string">
  Deposit instruction identifier
</ResponseField>

<ResponseField name="object" type="string">
  Always returns `"deposit_instruction"`
</ResponseField>

<ResponseField name="account_id" type="string">
  Parent account ID
</ResponseField>

<ResponseField name="currency" type="string">
  ISO 4217 currency code
</ResponseField>

<ResponseField name="recon_strategy" type="string">
  Reconciliation strategy: `virtual_account` or `memo_reference`
</ResponseField>

<ResponseField name="status" type="string">
  Status: `active` or `revoked`
</ResponseField>

<ResponseField name="beneficiary_name" type="string">
  Name of the beneficiary for the deposit
</ResponseField>

<ResponseField name="beneficiary_address" type="string">
  Address of the beneficiary
</ResponseField>

<ResponseField name="bank_name" type="string">
  Name of the receiving bank
</ResponseField>

<ResponseField name="bank_address" type="string">
  Address of the receiving bank
</ResponseField>

<ResponseField name="account_name" type="string">
  Name on the bank account
</ResponseField>

<ResponseField name="account_number" type="string">
  Bank account number
</ResponseField>

<ResponseField name="iban" type="string">
  International Bank Account Number
</ResponseField>

<ResponseField name="swift_bic" type="string">
  SWIFT/BIC code
</ResponseField>

<ResponseField name="routing_number" type="string">
  Bank routing number
</ResponseField>

<ResponseField name="sort_code" type="string">
  Sort code (UK banking)
</ResponseField>

<ResponseField name="memo" type="string">
  Memo or reference to include with transfers (for `memo_reference` strategy)
</ResponseField>

<ResponseField name="supported_rails" type="array">
  Supported payment rails (e.g., `ach`, `fedwire`, `swift`, `sepa`, `spei`)
</ResponseField>

<ResponseField name="created" type="string">
  ISO 8601 timestamp when created
</ResponseField>

<ResponseField name="updated" type="string">
  ISO 8601 timestamp when last updated
</ResponseField>

### When Unavailable

<ResponseField name="object" type="string">
  Returns `"deposit_instruction"`
</ResponseField>

<ResponseField name="currency" type="string">
  The requested currency code
</ResponseField>

<ResponseField name="status" type="string">
  Returns `"unavailable"`
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable explanation
</ResponseField>

## Response Examples

### Available

```json theme={null}
{
  "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"
}
```

### Unavailable

```json theme={null}
{
  "object": "deposit_instruction",
  "currency": "JPY",
  "status": "unavailable",
  "message": "Deposit instructions are not yet available for this currency. Please contact support."
}
```