---
title: "Update a virtual account"
method: PUT
path: "/virtual-accounts/{id}"
tags: ["Virtual-Accounts"]
---

# Update a virtual account

`PUT /virtual-accounts/{id}`

Update a virtual account

## Path parameters

- `id` string, required — ID of the virtual account.

## Headers

- `X-Trace-Id` string
- `X-Scenario-Key` string

## Request body

- VirtualAccountUpdateIn
  - `action_type` 'update_bvn' | 'update_status', required — The supported virtual account update actions.
  - `status` 'inactive' — The status of the virtual account.
  - `bvn` string — This is the customer's Bank Verification Number.
  - `meta` Meta

## Response `200`

OK

- object
  - `status` 'success' | 'failed'
  - `message` string
  - `data` VirtualAccount
    - `id` string — The virtual account ID.
    - `amount` number — The amount to be collected. Specify `0` for static accounts.
    - `account_number` string — The bank account number.
    - `reference` string — A custom identifier to track the transaction, This must be unique across all your transactions.
    - `account_bank_name` string — The name of the bank.
    - `account_type` 'static' | 'dynamic' — The type of virtual account.
    - `status` 'active' | 'inactive' — The status of the virtual account.
    - `account_expiration_datetime` string, date-time — The expiry date and time of the virtual account.
    - `note` string — A message providing instructions for the bank transfer, which includes the narration provided in the request.
    - `customer_id` string — The ID of the customer.
    - `created_datetime` string, date-time — The date and time when the virtual account was created..
    - `meta` Meta
    - `customer_reference` string — This is the reference the customer sends as narration when making the bank transfer
    - `currency` string — ISO 4217 currency code.
    - `narration` string — This allows you specify the name shown when the account is resolved.

## Other responses

- `400` — Bad request
- `401` — Unauthorised request
- `403` — Forbidden

---

[API](https://skmtc.net/flutterwave/apis/flutterwave-apis.md) · [All operations](https://skmtc.net/flutterwave/apis/flutterwave-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flutterwave/flutterwave-apis/revisions/6014190df2e9/schema)