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

# Introduction

> The Tally Platform API — versioned business identity state infrastructure.

Tally Platform is a versioned, durable API for managing business identity state. It stores structured identity data as an immutable ledger of snapshots and gives you cryptographic tools to verify that state has not been tampered with.

## What you can do

<CardGroup cols={2}>
  <Card title="Write identity state" icon="pen-to-square">
    Create and update structured identity records for organization and individual subjects via RFC 6902 JSON Patch operations.
  </Card>

  <Card title="Read with access control" icon="lock-open">
    Grant counterparty tenants scoped read access — latest state, full lineage, diffs, or specific versions.
  </Card>

  <Card title="Verify integrity" icon="shield-check">
    Each snapshot is hashed (RFC 8785 + SHA-256) and chain-linked. Verify any snapshot or the full chain independently.
  </Card>

  <Card title="Track attribute provenance" icon="route">
    Every attribute carries per-field metadata — source type, verification timing, and attesting actor.
  </Card>
</CardGroup>

## How it works

Identity data is organized around **subjects** (an organization or individual) with a **tenant** as the accountable owner. Each write creates a new immutable **snapshot**. Snapshots are hash-linked into a chain that any party can independently verify.

Counterparty access is explicit — you grant specific **scopes** to specific tenants. Nothing is shared by default.

## Base URLs

| Environment | URL                                                  |
| ----------- | ---------------------------------------------------- |
| Production  | `https://tally-platform-api-iikaevm4pq-ue.a.run.app` |
| Staging     | `https://tally-platform-api-xwka6vu2kq-ue.a.run.app` |

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Get a Firebase Auth JWT and make your first authenticated request.
  </Card>

  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Create a tenant, write your first identity state, and read it back.
  </Card>
</CardGroup>
