---
title: "Prepare force burn transaction"
method: POST
path: "/v1/issuance/tokens/{tokenId}/force-burn/prepare"
tags: ["Issuance"]
---

# Prepare force burn transaction

`POST /v1/issuance/tokens/{tokenId}/force-burn/prepare`

Builds an unsigned force burn transaction for client-side signing.

## Path parameters

- `tokenId` string, required — Token identifier.

## Headers

- `x-project-id` string — Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

## Request body

- object — Force burn request body.
  - `signingWalletId` string — Optional signer wallet — the `walletId` field returned by GET /v1/wallets. The wallet record `id` and the public key are not accepted.
  - `forceBurn` object, required — Forced burn details.
    - `source` string, required — Source wallet or token account to force-burn from.
    - `amount` string, required — Token amount in UI units (decimal string). Human-readable value such as "1" or "1.5". SDP converts to on-chain base units using the token's decimals field.
    - `delegateAuthority` string — Optional delegate authority address for the force burn.
    - `memo` string — Optional on-chain memo.
  - `options` object — Force burn execution options.
    - `priorityFee` union
      - 'none' | 'low' | 'medium' | 'high'
      - integer
    - `simulate` boolean

## Response `200`

Prepared force burn

- object — Standard success response envelope.
  - `data` object, required — Prepare force burn response payload.
    - `transaction` object, required — Force burn transaction record.
      - `id` string, required — Token transaction identifier.
      - `tokenId` string, required — Token identifier.
      - `organizationId` string, required — Organization identifier.
      - `type` 'mint' | 'burn' | 'freeze' | 'unfreeze' | 'seize' | 'force_burn' | 'update_authority' | 'pause' | 'unpause' | 'deploy', required — Transaction type.
      - `status` 'pending' | 'processing' | 'confirmed' | 'finalized' | 'failed', required — Transaction status.
      - `signature` string, nullable, required — Solana transaction signature.
      - `idempotencyKey` string — Idempotency key used for this request.
      - `idempotencyFingerprint` string — Request fingerprint used to validate idempotent retries.
      - `serializedTx` string, nullable, required — Base64-encoded transaction payload, if available.
      - `params` object, required — Operation parameters captured for audit.
      - `slot` integer, nullable, required — Slot number, if confirmed.
      - `blockTime` string, date-time, nullable, required — Block time, if confirmed.
      - `fee` integer, nullable, required — Transaction fee in lamports.
      - `error` string, nullable, required — Error message if the transaction failed.
      - `initiatedByKeyId` string, nullable, required — API key that initiated the transaction.
      - `createdAt` string, date-time, required — Creation timestamp.
      - `updatedAt` string, date-time, required — Last update timestamp.
    - `preparedTransaction` object, required — Prepared transaction for force burn.
      - `serialized` string, required — Base64-encoded unsigned transaction.
      - `blockhash` string, required — Blockhash for the transaction.
      - `lastValidBlockHeight` string, required — Last valid block height.
    - `simulation` object — Optional transaction simulation results.
      - `success` boolean, required — Simulation success flag.
      - `logs` string[], required — Simulation logs, if any.
      - `unitsConsumed` union, required — Compute units consumed.
        - number
        - string
        - unknown
      - `error` string, nullable, required — Simulation error, if any.
  - `meta` object, required — Response metadata.
    - `requestId` string, required — Request identifier for tracing.
    - `timestamp` string, date-time, required — ISO 8601 timestamp.

## Other responses

- `400` — Error
- `401` — Error
- `403` — Error
- `404` — Error
- `500` — Error

---

[API](https://skmtc.net/solana/apis/solana-developer-platform-api.md) · [All operations](https://skmtc.net/solana/apis/solana-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solana/solana-developer-platform-api/revisions/672b1916ba61/schema)