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

# Introduction

> Overview of the Simply Tokenized API.

<Warning>
  The current API version **`2026-07-02`** is in **beta** and is only available on the **development** environment. Request and response shapes may change before a stable release. Beta responses include `ST-Api-Version-Beta: true`. See [Versioning](/guides/versioning) for details.
</Warning>

The **Simply Tokenized API** lets integrators and partners programmatically access offerings, orders, accounts, wallets, and transactions for a tenant.

## Base URLs

All API routes are served under the `/_api` prefix:

| Environment     | Base URL                                  |
| --------------- | ----------------------------------------- |
| **Development** | `https://dev.go.simplytokenized.com/_api` |
| **Staging**     | `https://stage.go.floris3.com/_api`       |
| **Live**        | `https://go.floris3.com/_api`             |

Use **development** when integrating against the beta version `2026-07-02`. Staging and live use their respective Asset Manager tenants and credentials for that environment.

## API surfaces

This documentation covers two integrator-facing surfaces:

| Surface               | Description                                                               |
| --------------------- | ------------------------------------------------------------------------- |
| **API**               | REST endpoints under `/_api` for offerings, orders, accounts, and wallets |
| **Outbound webhooks** | Event notifications POSTed to your HTTPS endpoint when resources change   |

## Resource model

Authenticate once, then work with two resource trees: **offerings & orders** on the left, **accounts & related records** on the right.

<div style={{ display: 'flex', justifyContent: 'center', margin: '1.5rem 0' }}>
  <img src="https://mintcdn.com/gsq/BUkPddEqjXyzsDDm/images/resource-model.png?fit=max&auto=format&n=BUkPddEqjXyzsDDm&q=85&s=14bd06130c0674aa82b5ce95acd12913" alt="API resource model: auth branches to offerings/orders/webhooks and accounts/wallets/transactions/benefiting" width="640" data-path="images/resource-model.png" />
</div>

## Getting credentials

API credentials (`client_id` / `client_secret`) are created in the Asset Manager dashboard under **Administration → API Access → Tokens**. Each credential is scoped to one or more resource categories (`OFFERINGS`, `ACCOUNT`, `ORDER`, `WALLET`).

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/guides/quickstart">
    Authenticate and make your first API call.
  </Card>

  <Card title="Authentication" icon="key" href="/guides/authentication">
    Learn about tokens, scopes, and headers.
  </Card>

  <Card title="Units and decimals" icon="calculator" href="/guides/units-and-decimals">
    Convert token amounts to smallest-unit strings for orders and balances.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Browse all endpoints with schemas and examples.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks/overview">
    Receive real-time event notifications.
  </Card>
</CardGroup>
