Clawback MPT tokens

Recover tokens from a holder's account.

How clawback works

Clawback allows the issuer to forcibly recover tokens from a holder without their consent. This is useful for regulatory compliance, fraud recovery, or asset recall scenarios.

Clawback requires lsfMPTCanClawback to be set during issuance. This flag cannot be added after the MPT is created.

Prerequisites

You are the issuer of the MPT
The MPT has lsfMPTCanClawback enabled
The holder has tokens to claw back

Claw back tokens in the UI

To claw back tokens from a holder:

Go to Accounts and open the issuer account.
Click Create order and select Ledger-specific operations.
In Ledger, select the XRP Ledger network.
In Operation, select Clawback. A warning confirms that the action can't be reversed and is meant for regulatory compliance or to correct unauthorized transfers.
In Asset holder, select the holder's account.
Select the token and the amount:
- Listed asset — Select the token and enter the amount.
- Unlisted asset — In Type, select Multi-purpose token (MPT). Then enter the Token issuance ID and the Amount in base units. For example, with an asset scale of 2, enter 100000 to claw back 1,000.00 tokens.
Select a Fee Strategy, then click Submit for approval and sign the operation with the app. The signing window shows the operation as Clawback with the holder, the amount in base units, and the issuance ID.

Claw back tokens with the API

To clawback tokens from a holder, submit a Clawback transaction:

{
  "payload": {
    "id": "{{intent_id}}",
    "accountId": "{{issuer_account_id}}",
    "parameters": {
      "type": "XRPL",
      "feeStrategy": {
        "priority": "Medium",
        "type": "Priority"
      },
      "operation": {
        "type": "Clawback",
        "currency": {
          "issuanceId": "000004C463C52827307480341125DA0577AFFC21D4B2D083",
          "type": "MultiPurposeToken"
        },
        "holder": {
          "address": "rHolderAddress...",
          "type": "Address"
        },
        "value": "500000"
      }
    },
    "customProperties": {},
    "type": "v0_CreateTransactionOrder"
  }
}

Parameters

Field	Type	Required	Description
`currency.issuanceId`	string	Yes	The 192-bit MPT issuance ID.
`currency.type`	string	Yes	Must be `MultiPurposeToken`.
`holder`	object	Yes	The holder to claw back tokens from.
`holder.type`	string	Yes	One of: `Account` (internal account UUID), `Address` (XRPL address), or `Endpoint` (endpoint UUID).
`holder.address`	string	Conditional	The holder's XRPL address. Required when `holder.type` is `Address`.
`holder.accountId`	string	Conditional	Internal account UUID. Required when `holder.type` is `Account`.
`holder.endpointId`	string	Conditional	Endpoint UUID. Required when `holder.type` is `Endpoint`.
`value`	string	Yes	The amount to claw back (raw integer value).

Response

A successful request returns the transaction order with status Pending. After confirmation:

The holder's balance decreases by the clawed back amount.
The total supply decreases accordingly.
The issuer does not receive the tokens — they are removed from circulation.

Clawback frozen tokens

Clawback works even when a holder's tokens are frozen. This allows issuers to recover tokens from non-compliant or sanctioned addresses.

Typical workflow:

Freeze the holder's tokens to prevent transfers.
Clawback the tokens.
Optionally unfreeze the holder.

Multi-purpose tokens — Overview of MPT operations.
Freeze tokens — Freeze holder before clawback.
Clawback — XRPL transaction reference.