> For the complete documentation index, see [llms.txt](https://dev.plyr.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.plyr.network/api-reference/assets/badge.md).

# Badge

The Badge API provides endpoints for managing game badges (ERC-721 tokens) in the system. These endpoints allow you to create, mint, transfer, burn, and query badge information.

## Available Endpoints

### Creation

* [Create Badge](/api-reference/assets/badge/create-badge.md) - Create a new badge
* [Create Badge by Signature](https://github.com/onPlyr/dev-documents-gitbook/blob/main/api-reference/assets/badge/create-badge-by-signature.md) - Create a badge using a signature

### Minting

* [Mint Badge](/api-reference/assets/badge/mint-badge.md) - Mint a badge to a recipient

### Management

* [Remove Badge](/api-reference/assets/badge/remove-badge.md) - Remove a badge
* [Remove Badge by Signature](https://github.com/onPlyr/dev-documents-gitbook/blob/main/api-reference/assets/badge/remove-badge-by-signature.md) - Remove a badge using a signature
* [Burn Badge](/api-reference/assets/badge/burn-badge.md) - Burn a badge
* [Transfer Badge](broken://pages/pYxr9CEGIhzEBvxqP2yx) - Transfer a badge to another address

### Queries

* [Get Badge Balance](broken://pages/8Hc6d8Nvb86DdHMefEkz) - Get badge balance for an address
* [List Badges](/api-reference/assets/badge/list-badges.md) - List badges owned by an address
* [Get Badge Info](/api-reference/assets/badge/get-badge-info.md) - Get detailed information about a badge
* [Get Badge Count](broken://pages/LdTgfJ35q1840mGbOBKb) - Get total count of badges
* [Get Badge by ID](broken://pages/Qei02JnCELYwB6TqKLB4) - Get badge information by ID
* [Get Badge Owner](broken://pages/64yGn03k7laIjCE0WItP) - Get the owner of a badge
* [Check Badge Burn Status](broken://pages/dmBuAwpoN7juj06SIwD5) - Check if a badge is burnt

## Authentication

All endpoints require HMAC authentication using the `hmacAuth('user')` middleware. Make sure to include the following headers in your requests:

* `apikey`: Your API key
* `signature`: HMAC signature
* `timestamp`: Current timestamp

## Chain ID

Most endpoints require a chain ID to be specified. This can be done either in the request body or through the `checkChainId` middleware.