# Tally

## Docs

- [Snapshot Diff API: Compare Identity Versions](https://docs.tallychannel.com/api-reference/diffs.md): Compare two identity snapshots by version or snapshot ID. Tally returns RFC 6902 JSON Patch operations showing exactly what changed.
- [Entity State Updates API: Propose and Apply Patches](https://docs.tallychannel.com/api-reference/entity-state-updates.md): POST /v1/entity-state-updates and /apply — propose an RFC 6902 JSON Patch, then apply it to create a new immutable snapshot.
- [Entity States API: Submit Identity Snapshots](https://docs.tallychannel.com/api-reference/entity-states.md): POST /v1/entity-states and POST /v1/tenants/:id/entity-states — submit a new identity snapshot for an entity or individual subject.
- [API error codes and troubleshooting for Tally](https://docs.tallychannel.com/api-reference/errors.md): Tally returns structured JSON error envelopes with error codes and field-level details. Learn what each status code and error code means.
- [Grants API: Share Subject Access Across Tenants](https://docs.tallychannel.com/api-reference/grants.md): Create, list, and revoke access grants that give counterparty tenants read access to your subjects with specific data scopes.
- [Tally REST API Reference](https://docs.tallychannel.com/api-reference/overview.md): The Tally API is a JSON REST API versioned at /v1. All requests require an OIDC bearer token except the health endpoint.
- [Refresh Requests API: Request Updated Identity Data](https://docs.tallychannel.com/api-reference/refresh-requests.md): Create and fulfill refresh requests so counterparty tenants can signal when they need updated identity snapshots from subject owners.
- [Snapshot Read API: Query Identity History](https://docs.tallychannel.com/api-reference/snapshots.md): Read current state, list history, export, and fetch chain proofs for entity and individual subjects via the Tally snapshot endpoints.
- [Tenants API: Create and Manage Workspaces](https://docs.tallychannel.com/api-reference/tenants.md): POST /v1/tenants to create a tenant, manage members and roles with PUT /members, and track usage with GET /usage.
- [Webhooks API: Subscribe to Real-Time Events](https://docs.tallychannel.com/api-reference/webhooks.md): Create webhook subscriptions to receive HTTP POST notifications for snapshot creation and refresh request events in your tenant.
- [Authenticate API requests with bearer tokens](https://docs.tallychannel.com/authentication.md): Tally uses OIDC JWT bearer tokens for authentication. Learn how to obtain a token and include it in every API request.
- [Cryptographic Data Integrity in Tally](https://docs.tallychannel.com/concepts/data-integrity.md): Every snapshot is hashed using RFC 8785 canonicalization and SHA-256. Snapshots chain to each other so you can verify any history is untampered.
- [Grants: Cross-Tenant Data Sharing in Tally](https://docs.tallychannel.com/concepts/grants.md): Grants let you share read access to specific subjects with other tenants. Control which data scopes are shared and when the grant expires.
- [Identity Snapshots: Versioned State in Tally](https://docs.tallychannel.com/concepts/snapshots.md): Each snapshot captures the full identity state of a subject at a point in time. Snapshots are immutable and form a cryptographic chain.
- [Subjects: Entities and Individuals in Tally](https://docs.tallychannel.com/concepts/subjects.md): A subject is any entity or individual tracked in Tally. Learn how subjects are identified, typed, and owned within a tenant.
- [Tenants, Members, and Roles in Tally](https://docs.tallychannel.com/concepts/tenants-and-roles.md): Tenants are isolated workspaces in Tally. Control who can read, propose, write, or administer data with five membership roles.
- [Create and update identity snapshots with Tally](https://docs.tallychannel.com/guides/creating-snapshots.md): Submit your first entity or individual identity snapshot, then propose and apply JSON Patch updates to evolve the record over time.
- [Read and query identity snapshots from Tally](https://docs.tallychannel.com/guides/reading-identity-data.md): Fetch the current state, historical snapshots, and cryptographic diffs for any subject your tenant owns or has grant access to.
- [Request updated identity data with refresh requests](https://docs.tallychannel.com/guides/refresh-requests.md): Counterparty tenants can request fresh identity snapshots from subject owners. Learn how to create, track, and fulfill refresh requests.
- [Share identity data across tenants with grants](https://docs.tallychannel.com/guides/sharing-data-with-grants.md): Create scoped access grants so counterparty tenants can read your subject data, and list the subjects available to you through incoming grants.
- [Verify ledger integrity with the Tally CLI](https://docs.tallychannel.com/guides/verifying-exports.md): Export a subject's full snapshot history and verify its cryptographic integrity offline using the tally verify-ledger CLI command.
- [Subscribe to real-time events with Tally webhooks](https://docs.tallychannel.com/guides/webhooks.md): Subscribe your endpoint to receive HTTP notifications for snapshot creation and refresh request lifecycle events.
- [Tally: Verified Identity Data Platform](https://docs.tallychannel.com/introduction.md): Tally is a multi-tenant platform for storing, versioning, and sharing cryptographically verified identity data for KYC and KYB workflows.
- [Get started with Tally in 5 minutes](https://docs.tallychannel.com/quickstart.md): Create your first tenant, submit an identity snapshot, and read it back using the Tally REST API or TypeScript SDK.
- [Tally SDK Overview](https://docs.tallychannel.com/sdk/overview.md): Tally provides a TypeScript SDK and a CLI tool for verifying ledger integrity. Choose the right integration method for your use case.
- [@tally/sdk TypeScript Client Reference](https://docs.tallychannel.com/sdk/typescript-sdk.md): Full reference for the @tally/sdk TypeScript client. Create a client, call subjects, snapshots, updates, tenants, refresh requests, and webhooks.