What exactly is a token?

A token is a usage credit on anonym.legal. Every analyze, anonymize, or decrypt operation deducts a small number from your account balance. You always see the exact cost before each operation, and credits are only spent on operations that succeed.

How is a billing token different from a tokenized PII placeholder?

They share the word but mean different things. A billing token is the credit you spend on operations. A tokenized PII placeholder (like ) is the technical string that replaces a real name in your text during anonymization. You do not pay per placeholder — you pay per operation.

How many tokens come with each plan?

Free: 200 tokens per 30-day cycle. Basic (€3 / month): 1,000 tokens per 31-day cycle. Pro (€15 / month): 4,000. Business (€29 / month): 10,000. Unused balance does not roll over.

How much does it cost to analyze one page of text?

Cost grows with text length and with the personal data found: a short contract costs a few tokens, a long document with dense personal-data tables considerably more. The current costs for typical document sizes and an interactive calculator are on the token system page (/docs/token-system). The exact cost appears next to every operation button in the web app and via the free estimate endpoint in the API.

How do I check my current token balance?

In the web app, go to Settings → Account. In the API, call the free /api/mcp/balance endpoint or the anonym_legal_get_balance MCP tool. Both return your remaining balance, cycle start, and cycle end.

How do I estimate cost before running an operation?

Two ways. In the web app, the cost preview appears next to each operation button before you click. In the API, use the free anonym_legal_estimate_cost MCP tool — it returns the exact deduction without running the operation.

What is the rule of thumb for token cost?

Analysis cost depends on the text length (per 1,000 characters), the number of enabled entity types and the number of matches; anonymization adds a small amount per operator and per encrypted entity type. The tokens charged are shown with every result. A real Anonymize click costs analyze + apply combined. Decrypt is the cheapest operation. A worked example with the current rates is on the token system page (/docs/token-system).

Does choosing a different operator change the cost?

Replace, redact, mask, and hash all cost the same on the same input — pick whichever fits your privacy goal. Encrypt is the cost outlier: it adds a per-entity term to the apply step, so it costs noticeably more on small inputs (less on large ones). If you do not need to recover the originals, prefer one of the non-encrypt operators.

Does the language of the text affect cost?

Cost is driven by characters and detected entities, not by language. A short sentence in any of the 48 supported languages costs only a few tokens.

Do unused tokens roll over to the next cycle?

No. Allocations and top-ups both reset at the end of each billing cycle. Plan ahead and buy top-ups close to when you will use them. This is a real limitation for unpredictable, high-volume workloads: because cost scales with document size and PII density, a burst of larger or denser documents can exhaust your allocation before the cycle resets — budget with headroom rather than the bare average cost when deciding whether to upgrade.

What happens if I run out of tokens mid-task?

The next operation returns a 402 Payment Required response with the exact shortfall. You can buy a top-up immediately (on paid plans) or wait for the cycle to reset.

Can I buy more tokens during a cycle?

Yes — on Basic, Pro, and Business plans you can purchase top-ups. Rates: Basic €1 = 250 tokens, Pro €1 = 300 tokens, Business €1 = 350 tokens. Free plan users need to upgrade to enable top-ups.

Do top-up tokens expire?

Yes. Top-up tokens expire at the next cycle reset, the same as your monthly allocation. They do not carry over.

Do failed operations cost anything?

No. Credits are only deducted after a successful operation. Validation errors, server errors, and rejected requests cost zero tokens.

How does AI Entity Creation pricing work?

Creating a custom entity recognizer with AI costs a flat 50 tokens per request, deducted from your current cycle balance. The cost is shown before each call and may change with prior notice.

By George Curta · Last updated 2026-10-22

Back to the Token System guide

Docs / Token System / FAQ

Token System — Frequently Asked Questions

Quick answers about how tokens work, what they cost, and how to make the most of your balance.

The basics

What exactly is a token?: A token is a usage credit on anonym.legal. Every analyze, anonymize, or decrypt operation deducts a small number from your account balance. You always see the exact cost before each operation, and credits are only spent on operations that succeed.
How is a billing token different from a tokenized PII placeholder?: They share the word but mean different things. A billing token is the credit you spend on operations. A tokenized PII placeholder (like <PERSON_1>) is the technical string that replaces a real name in your text during anonymization. You do not pay per placeholder — you pay per operation.
How do I check my current token balance?: In the web app, go to Settings → Account. In the API, call the free /api/mcp/balance endpoint or the anonym_legal_get_balance MCP tool. Both return your remaining balance, cycle start, and cycle end.

Allocations & limits

How many tokens come with each plan?: Free: 200 tokens per 30-day cycle. Basic (€3 / month): 1,000 tokens per 31-day cycle. Pro (€15 / month): 4,000. Business (€29 / month): 10,000. Unused balance does not roll over.
Do unused tokens roll over to the next cycle?: No. Allocations and top-ups both reset at the end of each billing cycle. Plan ahead and buy top-ups close to when you will use them. This is a real limitation for unpredictable, high-volume workloads: because cost scales with document size and PII density, a burst of larger or denser documents can exhaust your allocation before the cycle resets — budget with headroom rather than the bare average cost when deciding whether to upgrade.

Cost & estimation

How much does it cost to analyze one page of text?: Cost grows with text length and with the personal data found: a short contract costs a few tokens, a long document with dense personal-data tables considerably more. The current costs for typical document sizes and an interactive calculator are on the token system page (/docs/token-system). The exact cost appears next to every operation button in the web app and via the free estimate endpoint in the API.
How do I estimate cost before running an operation?: Two ways. In the web app, the cost preview appears next to each operation button before you click. In the API, use the free anonym_legal_estimate_cost MCP tool — it returns the exact deduction without running the operation.
What is the rule of thumb for token cost?: Analysis cost depends on the text length (per 1,000 characters), the number of enabled entity types and the number of matches; anonymization adds a small amount per operator and per encrypted entity type. The tokens charged are shown with every result. A real Anonymize click costs analyze + apply combined. Decrypt is the cheapest operation. A worked example with the current rates is on the token system page (/docs/token-system).
Does choosing a different operator change the cost?: Replace, redact, mask, and hash all cost the same on the same input — pick whichever fits your privacy goal. Encrypt is the cost outlier: it adds a per-entity term to the apply step, so it costs noticeably more on small inputs (less on large ones). If you do not need to recover the originals, prefer one of the non-encrypt operators.
Does the language of the text affect cost?: Cost is driven by characters and detected entities, not by language. A short sentence in any of the 48 supported languages costs only a few tokens.

Edge cases

What happens if I run out of tokens mid-task?: The next operation returns a 402 Payment Required response with the exact shortfall. You can buy a top-up immediately (on paid plans) or wait for the cycle to reset.
Do failed operations cost anything?: No. Credits are only deducted after a successful operation. Validation errors, server errors, and rejected requests cost zero tokens.
How does AI Entity Creation pricing work?: Creating a custom entity recognizer with AI costs a flat 50 tokens per request, deducted from your current cycle balance. The cost is shown before each call and may change with prior notice.

Top-ups & expiry

Can I buy more tokens during a cycle?: Yes — on Basic, Pro, and Business plans you can purchase top-ups. Rates: Basic €1 = 250 tokens, Pro €1 = 300 tokens, Business €1 = 350 tokens. Free plan users need to upgrade to enable top-ups.
Do top-up tokens expire?: Yes. Top-up tokens expire at the next cycle reset, the same as your monthly allocation. They do not carry over.

Still have a question?

Reach out to our support team or browse the full glossary and platform documentation.