{"templateId":"markdown","versions":[{"version":"v1.43","label":"v1.43 LTS","link":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/issuer/destroy-issuance","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.42","label":"v1.42 STS","link":"/products/custody/v1.42/accounts-and-assets/tokenization/xrpl-mpts/issuer/destroy-issuance","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.41","label":"v1.41 STS","link":"/products/custody/v1.41/accounts-and-assets/tokenization/xrpl-mpts/issuer/destroy-issuance","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/destroy-issuance","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/destroy-issuance","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/destroy-issuance","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/destroy-issuance","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Destroy an MPT issuance","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":"destroy-an-mpt-issuance","__idx":0},"children":["Destroy an MPT issuance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Permanently retire an MPT from the XRP Ledger."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-destruction-works","__idx":1},"children":["How destruction works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPTokenIssuanceDestroy"]}," transaction permanently removes an MPT issuance from the ledger. Once destroyed, the MPT cannot be recreated, and its issuance ID is retired."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can only destroy an MPT when the total supply is zero. All tokens must be burned before destruction."]}]},{"$$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 total supply is zero (all tokens have been burned)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No holders have remaining token balances"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"destroy-an-mpt-issuance-1","__idx":3},"children":["Destroy an MPT issuance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To destroy an MPT, submit an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPTokenIssuanceDestroy"]}," 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\": \"MPTokenIssuanceDestroy\",\n \"tokenIdentifier\": {\n \"issuanceId\": \"000004C463C52827307480341125DA0577AFFC21D4B2D083\",\n \"type\": \"MPTokenIssuanceId\"\n }\n }\n },\n \"customProperties\": {},\n \"type\": \"v0_CreateTransactionOrder\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parameters","__idx":4},"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":["tokenIdentifier.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 to destroy."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenIdentifier.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":["MPTokenIssuanceId"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response","__idx":5},"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 MPT issuance is permanently removed from the ledger."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The issuer's owner reserve is freed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The issuance ID can never be reused."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"preparation-workflow","__idx":6},"children":["Preparation workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before destroying an MPT, ensure all tokens are burned:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Check supply"]}," — Query the MPT issuance to verify total supply."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clawback remaining tokens"]}," — Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.42/accounts-and-assets/tokenization/xrpl-mpts/issuer/clawback"},"children":["clawback"]}," to recover tokens from holders."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Burn tokens"]}," — Ensure any tokens returned to issuer are burned."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Destroy issuance"]}," — Submit the destroy transaction."]}]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"flowchart LR\n A[Check supply] --> B{Supply = 0?}\n B -->|No| C[Clawback tokens]\n C --> A\n B -->|Yes| D[Destroy issuance]\n","diagramHtml":"

No

Yes

Check supply

Supply = 0?

Clawback tokens

Destroy issuance

","diagramHtmlDark":"

No

Yes

Check supply

Supply = 0?

Clawback tokens

Destroy issuance

"},"children":["flowchart LR\n A[Check supply] --> B{Supply = 0?}\n B -->|No| C[Clawback tokens]\n C --> A\n B -->|Yes| D[Destroy issuance]\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-topics","__idx":7},"children":["Related topics"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.42/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/v1.42/accounts-and-assets/tokenization/xrpl-mpts/issuer/burn"},"children":["Burn tokens"]}," — Reduce token supply."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.42/accounts-and-assets/tokenization/xrpl-mpts/issuer/clawback"},"children":["Clawback"]}," — Recover tokens from holders."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/mptokenissuancedestroy.html","target":"_blank"},"children":["MPTokenIssuanceDestroy"]}," — XRPL transaction reference."]}]}]},"headings":[{"value":"Destroy an MPT issuance","id":"destroy-an-mpt-issuance","depth":1},{"value":"How destruction works","id":"how-destruction-works","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Destroy an MPT issuance","id":"destroy-an-mpt-issuance-1","depth":2},{"value":"Parameters","id":"parameters","depth":2},{"value":"Response","id":"response","depth":2},{"value":"Preparation workflow","id":"preparation-workflow","depth":2},{"value":"Related topics","id":"related-topics","depth":2}],"frontmatter":{"seo":{"title":"Destroy an MPT issuance"}},"lastModified":"2026-10-23T14:40:24.018Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.42/accounts-and-assets/tokenization/xrpl-mpts/issuer/destroy-issuance","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}