---
title: "Burn Tokens"
method: POST
path: "/accounts/{account_id}/tokens/burns"
tags: ["Orders"]
---

# Burn Tokens

`POST /accounts/{account_id}/tokens/burns`

Burn (destroy) tokens from an address. Only available for tokenization/self-attested accounts.

## Path parameters

- `account_id` string, required — ID of the resource

## Request body

- CreateBurn
  - `amount` string, required — Amount to burn as a decimal string
  - `note` string
  - `source` BurnSource, required
    - `address_id` string, required — Brale address ID
    - `transaction_id` string, nullable — On-chain transaction hash
    - `transfer_type` string, required — Blockchain/chain name
    - `value_type` string, required — Token ticker

## Response `201`

OK

- BurnResponse
  - `amount` string — Amount burned
  - `created_at` string, date-time
  - `id` string — Order ID
  - `source` BurnSource
    - `address_id` string, required — Brale address ID
    - `transaction_id` string, nullable — On-chain transaction hash
    - `transfer_type` string, required — Blockchain/chain name
    - `value_type` string, required — Token ticker
  - `status` string — Transaction status
  - `updated_at` string, date-time

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/brale/apis/brale-api.md) · [All operations](https://skmtc.net/brale/apis/brale-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brale/brale-api/revisions/7446d49997c2/schema)