Burn Token

Burns a token.

You will see Submitted in the response even when you enter the wrong token ID, the from and owner are different, or when from is not authorized to burn the token. But that does not mean that it is successfully Committed. To confirm transaction status, use Get Transaction Receipt from the Wallet API.

From

from is the address that sends the transaction. If from is an account in the default account-pool of KIP-17 or Wallet Service, you can omit the KRN header.
Otherwise you need to include the KRN header (x-krn: krn:{chain-id}:wallet:{account-id}:account-pool:{pool name}).

Request
Security:
basic
path Parameters
contract-address-or-alias
required
string

Contract address (in hex.) or alias.

token-id
required
string

The ID of the token to burn.

header Parameters
x-chain-id
required
string

Kaia Network Chain ID (1001 or 8217)

x-krn
string

KRN (KAS Resource Name) unique to an Account Pool

Request Body schema: application/json
from
required
string

The Kaia account address of the owner or another party authorized to burn the token.

Responses
200

Your request was successful.

400

Your request is not valid.

401

The credential you entered is invalid.

delete/v2/contract/{contract-address-or-alias}/token/{token-id}
Request samples
application/json
{
  • "from": "0xDc277E2D89b92336A4ee80be3c7142443FDaDE47"
}
Response samples
application/json

Your request was successful.

{
  • "status": "Submitted",
  • "transactionHash": "0xbf6de339cf435447e58da05384bbf83a16fea40044bb49b84e11d3b00ea0325f"
}