Skip to main content
Tally is a multi-tenant identity data platform built for KYC/KYB workflows. It gives every entity or individual a versioned, immutable ledger of identity snapshots, each signed with a cryptographic hash chain so you can prove data integrity at any point in time. Share access to that data across tenants with fine-grained permission grants — and get notified in real time via webhooks whenever something changes.

Quickstart

Make your first API call and create your first identity snapshot in minutes.

Authentication

Learn how to authenticate your API requests using OIDC bearer tokens.

Core Concepts

Understand subjects, snapshots, tenants, grants, and data integrity.

API Reference

Explore the full REST API with request and response examples.

​
How Tally works

Tally organizes identity data around a few key ideas:
1

Create a subject

Every person or organization you track is a subject — either an entity (organization) or individual. Subjects are identified by a stable subject_id you control.
2

Submit identity snapshots

Post an Entity State Envelope to capture the current identity state of a subject. Each snapshot is immutable and versioned. Tally hashes it with SHA-256 over the RFC 8785 canonical form and chains it to the previous snapshot.
3

Share access with grants

Grants let your tenant share read access to specific subjects with counterparty tenants. You control which data scopes are exposed and when grants expire.
4

Stay in sync with webhooks

Subscribe to webhook events to receive real-time notifications when snapshots are created or refresh requests arrive, without polling.

​
Key capabilities

Immutable Ledger

Every snapshot is permanently stored and hash-chained — you can always prove what data existed at any point in time.

Cross-Tenant Sharing

Grant other tenants scoped read access to your subjects without exposing your entire data set.

TypeScript SDK

A fully typed SDK makes it easy to integrate Tally into Node.js applications with minimal boilerplate.

Refresh Requests

Counterparties can signal when they need updated identity data, keeping all parties in sync.

CLI Verification

The tally CLI lets you verify the integrity of any exported ledger offline with a single command.

Canonical Schema

Built-in schemas for organizations and individuals align with KYC/KYB requirements out of the box.

​
Explore the docs

Creating Snapshots

Step-by-step guide to submitting your first entity state snapshot.

Sharing Data with Grants

How to grant counterparty tenants access to your subjects.

Webhooks

Subscribe to real-time events for snapshots and refresh requests.

TypeScript SDK

Full reference for the @tally/sdk TypeScript client library.