---
title: "Destroy supply of virtual currency"
method: PUT
path: "/v3/ledger/virtualCurrency/revoke"
tags: ["Virtual Currency"]
---

# Destroy supply of virtual currency

`PUT /v3/ledger/virtualCurrency/revoke`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v3/ledger/virtualCurrency/revoke`
- Auth: API key in header `x-api-key`

/v3/ledger/virtualCurrency/revoke

#### 2 credits per API call.

  

Destroy supply of virtual currency linked on the given accountId. Method decreases the total supply of the currency.  
This method creates Ledger transaction with operationType REVOKE with undefined counterAccountId.

## Request body

- VirtualCurrencyOperation
  - `accountId` string, required: Ledger account with currency of the virtual currency, on which the operation will be performed.
  - `amount` string, required: Amount of virtual currency to operate within this operation.
  - `paymentId` string: Identifier of the payment, shown for created Transaction within Tatum sender account.
  - `reference` string: Reference of the payment.
  - `transactionCode` string: For bookkeeping to distinct transaction purpose.
  - `recipientNote` string: Note visible to both, sender and recipient. Available for both Mint and Revoke operations
  - `counterAccount` string: External account identifier. By default, there is no counterAccount present in the transaction.
  - `senderNote` string: Note visible to sender. Available in Revoke operation.

## Response `200`

OK

- TransactionResult
  - `reference` string: The internal reference to the transaction (a unique identifier of the transaction within the virtual account); if the transaction fails, use this reference to search through the logs

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/virtual-accounts.md) - [All operations](https://skmtc.dev/tatum/apis/virtual-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/virtual-accounts/revisions/ba220553084b?raw)