{"templateId":"markdown","versions":[{"version":"v1.43","label":"v1.43 LTS","link":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/issuer/clawback","default":true,"active":true,"folderId":"c15a2701"},{"version":"v1.42","label":"v1.42 STS","link":"/products/custody/v1.42/accounts-and-assets/tokenization/xrpl-mpts/issuer/clawback","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.41","label":"v1.41 STS","link":"/products/custody/v1.41/accounts-and-assets/tokenization/xrpl-mpts/issuer/clawback","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/accounts-and-assets/tokenization/xrpl-mpts/issuer/clawback","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/accounts-and-assets/tokenization/xrpl-mpts/issuer/clawback","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/accounts-and-assets/tokenization/xrpl-mpts/issuer/clawback","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/accounts-and-assets/tokenization/xrpl-mpts/issuer/clawback","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","img"]},"type":"markdown"},"seo":{"title":"Clawback MPT tokens","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"clawback-mpt-tokens","__idx":0},"children":["Clawback MPT tokens"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Recover tokens from a holder's account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-clawback-works","__idx":1},"children":["How clawback works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Clawback requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lsfMPTCanClawback"]}," to be set during issuance. This flag cannot be added after the MPT is created."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You are the issuer of the MPT"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The MPT has ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lsfMPTCanClawback"]}," enabled"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The holder has tokens to claw back"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"claw-back-tokens-in-the-ui","__idx":3},"children":["Claw back tokens in the UI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To claw back tokens from a holder:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accounts"]}," and open the issuer account."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create order"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ledger-specific operations"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ledger"]},", select the XRP Ledger network."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Operation"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clawback"]},". A warning confirms that the action can't be reversed and is meant for regulatory compliance or to correct unauthorized transfers."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Asset holder"]},", select the holder's account."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select the token and the amount:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Listed asset"]}," — Select the token and enter the amount."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unlisted asset"]}," — In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Multi-purpose token (MPT)"]},". Then enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token issuance ID"]}," and the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Amount"]}," in base units. For example, with an asset scale of 2, enter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["100000"]}," to claw back 1,000.00 tokens."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mpt-ui-clawback-form.a3c2c08fbc8371a8ac91e2dfb08c85d1f88d5f266d1e3dc84b5b869fbfc39897.93c15c9d.png","alt":"The Clawback form with an unlisted MPT","framed":false,"withLightbox":false,"width":"50%"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fee Strategy"]},", then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submit for approval"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/identity-and-access/authentication/ui-authentication#sign-ui-operations"},"children":["sign the operation with the app"]},". The signing window shows the operation as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clawback"]}," with the holder, the amount in base units, and the issuance ID."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mpt-ui-clawback-approval.81bb72856a8395b321906811fd42efa2dee4d6bab1650e2f1f6546cfaee2846b.93c15c9d.png","alt":"The signing window for a Clawback operation","framed":false,"withLightbox":false,"width":"75%"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"claw-back-tokens-with-the-api","__idx":4},"children":["Claw back tokens with the API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To clawback tokens from a holder, submit a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Clawback"]}," transaction:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"payload\": {\n    \"id\": \"{{intent_id}}\",\n    \"accountId\": \"{{issuer_account_id}}\",\n    \"parameters\": {\n      \"type\": \"XRPL\",\n      \"feeStrategy\": {\n        \"priority\": \"Medium\",\n        \"type\": \"Priority\"\n      },\n      \"operation\": {\n        \"type\": \"Clawback\",\n        \"currency\": {\n          \"issuanceId\": \"000004C463C52827307480341125DA0577AFFC21D4B2D083\",\n          \"type\": \"MultiPurposeToken\"\n        },\n        \"holder\": {\n          \"address\": \"rHolderAddress...\",\n          \"type\": \"Address\"\n        },\n        \"value\": \"500000\"\n      }\n    },\n    \"customProperties\": {},\n    \"type\": \"v0_CreateTransactionOrder\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parameters","__idx":5},"children":["Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency.issuanceId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The 192-bit MPT issuance ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MultiPurposeToken"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["holder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The holder to claw back tokens from."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["holder.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One of: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Account"]}," (internal account UUID), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Address"]}," (XRPL address), or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Endpoint"]}," (endpoint UUID)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["holder.address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The holder's XRPL address. Required when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["holder.type"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Address"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["holder.accountId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal account UUID. Required when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["holder.type"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Account"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["holder.endpointId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Endpoint UUID. Required when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["holder.type"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Endpoint"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The amount to claw back (raw integer value)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response","__idx":6},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful request returns the transaction order with status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Pending"]},". After confirmation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The holder's balance decreases by the clawed back amount."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The total supply decreases accordingly."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The issuer does not receive the tokens — they are removed from circulation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"clawback-frozen-tokens","__idx":7},"children":["Clawback frozen tokens"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Clawback works even when a holder's tokens are frozen. This allows issuers to recover tokens from non-compliant or sanctioned addresses."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Typical workflow:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/issuer/freeze"},"children":["Freeze"]}," the holder's tokens to prevent transfers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Clawback the tokens."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/issuer/freeze"},"children":["unfreeze"]}," the holder."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-topics","__idx":8},"children":["Related topics"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts#supported-operations"},"children":["Multi-purpose tokens"]}," — Overview of MPT operations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/issuer/freeze"},"children":["Freeze tokens"]}," — Freeze holder before clawback."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/transactions/types/clawback","target":"_blank"},"children":["Clawback"]}," — XRPL transaction reference."]}]}]},"headings":[{"value":"Clawback MPT tokens","id":"clawback-mpt-tokens","depth":1},{"value":"How clawback works","id":"how-clawback-works","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Claw back tokens in the UI","id":"claw-back-tokens-in-the-ui","depth":2},{"value":"Claw back tokens with the API","id":"claw-back-tokens-with-the-api","depth":2},{"value":"Parameters","id":"parameters","depth":2},{"value":"Response","id":"response","depth":2},{"value":"Clawback frozen tokens","id":"clawback-frozen-tokens","depth":2},{"value":"Related topics","id":"related-topics","depth":2}],"frontmatter":{"seo":{"title":"Clawback MPT tokens"}},"lastModified":"2026-10-23T14:40:24.141Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/issuer/clawback","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}