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

# Terminate Virtual Account

> Close a virtual account permanently

Sets the virtual account's status to `terminated` and closes its bank details. Termination is permanent: a terminated virtual account cannot be reopened, and its account number is not issued again. The request takes no body.

Only an `active` virtual account can be terminated, and all three balances (`available`, `pending_payin` and `held_for_payout`) must be zero. Move the funds out first with a [payout](https://apidocs.hopnow.io/fx/api-reference/payouts/create-payout.md) or a [transfer](https://apidocs.hopnow.io/fx/api-reference/transfers/create-transfer.md), and wait for pending deposits and payouts to finish. A `pending` or `frozen` virtual account can only be closed by Hop.

The call is idempotent: terminating an already-terminated virtual account returns `200` with the virtual account unchanged.

Tell your payers to stop using the bank details before you terminate. A deposit sent to a terminated virtual account is not credited.

A `virtual_account.updated` [webhook](https://apidocs.hopnow.io/fx/webhooks/events.md) is sent when the status changes.

Requires an API key with `write` access on the `virtual_accounts` scope.

## Path Parameters

**account\_id** `string` *required*

The account's external ID (starts with `acct_`)

**group\_id** `string` *required*

The [virtual account group](https://apidocs.hopnow.io/fx/api-reference/virtual-account-groups/create-group.md)'s external ID (starts with `vag_`)

**virtual\_account\_id** `string` *required*

The virtual account's external ID (starts with `va_`)

## Response

Returns the full virtual account object, the same shape as [Get Virtual Account](https://apidocs.hopnow.io/fx/api-reference/virtual-accounts/get-virtual-account.md), with `status` set to `terminated`.

## Errors

| Status | `code` | When |
| - | - | - |
| `404` | `RESOURCE_NOT_FOUND` | No such virtual account in this group on this account |
| `422` | `VIRTUAL_ACCOUNT_HAS_BALANCE` | A balance is not zero. `details` carry `available`, `pending_payin` and `held_for_payout`. |
| `422` | `VIRTUAL_ACCOUNT_STATUS_TRANSITION_INVALID` | The virtual account is `pending` or `frozen`. `details` carry `current_status`. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.