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

# Overview

Tokens are digital assets managed by the Neuron platform and governed by smart contracts with associated state machines. The Token endpoints let you query token metadata, retrieve creation attributes, inspect event histories, and annotate tokens with text or XML notes.

All endpoints require a valid JWT bearer token. Access to a token is subject to the authorization rules defined in the token's governing contract.

## Endpoints

| Endpoint                                                                            | Description                                                                  |
| ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| [Get token](/neuron-api/api-reference/tokens/get-token)                             | Retrieve full metadata for a single token by ID.                             |
| [Get tokens](/neuron-api/api-reference/tokens/get-tokens)                           | List tokens owned by or accessible to the authenticated account.             |
| [Get contract tokens](/neuron-api/api-reference/tokens/get-contract-tokens)         | List all tokens created under a specific smart contract.                     |
| [Get description](/neuron-api/api-reference/tokens/get-description)                 | Retrieve a human-readable description of a token.                            |
| [Get creation attributes](/neuron-api/api-reference/tokens/get-creation-attributes) | Retrieve the attributes that were set when the token was originally created. |
| [Get token events](/neuron-api/api-reference/tokens/get-token-events)               | Retrieve the event history of a token (state transitions, transfers, etc.).  |
| [Add text note](/neuron-api/api-reference/tokens/add-text-note)                     | Attach a plain text annotation to a token.                                   |
| [Add XML note](/neuron-api/api-reference/tokens/add-xml-note)                       | Attach a structured XML annotation to a token.                               |

## Token structure

Tokens are linked to:

* A **smart contract** that defines their rules and roles — see [Contracts](/neuron-api/api-reference/contracts/overview).
* A **state machine** that tracks their lifecycle — see [State machines](/neuron-api/api-reference/state-machines/overview).

Use [Get token events](/neuron-api/api-reference/tokens/get-token-events) to trace state transitions over time. Use [Get current state](/neuron-api/api-reference/state-machines/get-current-state) for the live state.

## Related

* [Tokens flow guide](/neuron-api/guides/tokens-flow) — walkthrough of querying tokens, attributes, and events.
* [State machines](/neuron-api/api-reference/state-machines/overview) — inspect and report on a token's state machine.
* [Contracts](/neuron-api/api-reference/contracts/overview) — the contracts that govern token behaviour.