Skip to main content
Tally exposes its identity data platform through two complementary developer tools. The @tally/sdk TypeScript package gives you a fully typed programmatic client for building applications against every Tally API endpoint. The @tally/cli command-line tool lets you audit and verify exported ledger snapshots without writing any code. Pick the tool — or combine both — based on what you’re building.

​
Available tools

TypeScript SDK

@tally/sdk — A fully typed HTTP client built on undici. Use it to read and write subject snapshots, manage tenants, propose updates, handle refresh requests, and subscribe to webhooks — all from your TypeScript or Node.js application.

CLI Tool

@tally/cli — A command-line utility for offline ledger verification. Use it to validate exported snapshot chains, check envelope hashes, and confirm cryptographic integrity without needing API credentials.

​
When to use each

Use the TypeScript SDK when you are building an application that needs to interact with the Tally API at runtime — for example, integrating identity data into a customer portal, automating update proposals in a data pipeline, or managing tenant memberships programmatically. Use the CLI when you need to perform a point-in-time audit or compliance check. The CLI works entirely from exported data, so it is well suited for security reviews, scheduled integrity jobs, and environments where you want to verify the ledger without establishing a live API connection. You can use both together: the SDK to export a subject’s snapshot history and the CLI to verify the resulting file independently.

​
Requirements

  • Node.js ≥ 20 — both the SDK and the CLI target the Node.js 20 LTS runtime or later. The SDK uses undici for HTTP and relies on native URL and fetch globals that are stable in Node.js 20+.
  • A valid JWT token issued by Tally (required for all authenticated SDK calls; not needed for offline CLI verification).