> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brale.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Token Burn

> Burn tokens from a source address. Only available for tokenization (self-attested) accounts.

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

Required scope: `self_attested_tokens:burn`.

Use an `Idempotency-Key` header. Only available for tokenization (self-attested) accounts.

## Path parameters

| Name | Type | Description |
| - | - | - |
| `account_id` | string | KSUID of the tokenization account performing the burn. |

## Request body

| Field | Type | Required | Description |
| - | - | - | - |
| `amount` | string | Yes | Amount to burn, as a decimal string. |
| `note` | string | No | Optional free-text note attached to the burn. |
| `source.address_id` | string | Yes | KSUID of the source address holding the tokens to burn. |
| `source.value_type` | string | Yes | The token value type (e.g., `MY_TOKEN`). |
| `source.transfer_type` | string | Yes | The chain the tokens are held on (e.g., `base`, `solana`). |

## Example request

```bash theme={null}
curl --request POST \
  --url https://api.brale.xyz/accounts/{account_id}/tokens/burns \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <uuid>' \
  --data '{
    "amount": "1000.50",
    "note": "Monthly burn for Q1 2024",
    "source": {
      "address_id": "2VcUIIsgARwVbEGlIYbhg6fGG57",
      "value_type": "MY_TOKEN",
      "transfer_type": "base"
    }
  }'
```

## Example success response

```json theme={null}
{
  "id": "2XyBurnKsuid000000000000000",
  "status": "pending",
  "amount": "1000.50",
  "source": {
    "address_id": "2VcUIIsgARwVbEGlIYbhg6fGG57",
    "value_type": "MY_TOKEN",
    "transfer_type": "base"
  },
  "created_at": "2025-01-15T12:00:00Z"
}
```

## Example error response

```json theme={null}
{
  "status": 400,
  "title": "Bad Request",
  "detail": "Insufficient balance at source address for requested burn amount."
}
```

## Related endpoints

* [List token burns](https://docs.brale.xyz/api-reference/brale/list-token-burns.md)
* [Get token burn](https://docs.brale.xyz/api-reference/brale/get-token-burn.md)
* [Tokenization guide](https://docs.brale.xyz/guides/tokenization.md)