Documentation
TheHumanBehind is a trust registry where a real, accountable person puts on record that an AI avatar, a voice, an agent or any other AI creation is theirs. These pages are the reference for how the registry works, from creating your first record to verifying one cryptographically, byte by byte, and consuming it through the public API.
What the registry is, and is not
Section titled “What the registry is, and is not”The core idea is small and deliberate. Behind every synthetic voice, avatar or agent there is a human who decided to create it and who answers for it. The registry lets that person say so, publicly, with a tamper-proof date and a fingerprint anyone can recheck. That is the whole product.
- It is a public, searchable directory of verified records and the people accountable for them; a way to put a dated, verifiable declaration of responsibility on record, private while it is free and public once you verify it; and an open API so anyone can consult and verify a verified record without asking permission.
- It is not an official or government registry, it is not required by any law, and registering does not by itself make you compliant with anything. TheHumanBehind is an independent, private registry that helps you put accountability on the record.
Explore the docs
Section titled “Explore the docs”Getting started
Create your account and register your first record in minutes. What you need, what happens on submit, and what stays private until you verify.
Records
Every field of a record, the THB registry number, what can never change, and the exact SHA-256 content-hash recipe with worked examples in shell, Python and Node.
Directory
Search and consult the registry: search by name or THB number, filter by type and scope, read a record page. Free, open to everyone, no account needed.
Verification
The gold Verified level, not open yet: what the identity check confirms, what it costs, what is stored (never your ID document) and what changes in your record.
Public API
The v0 contract: one JSON endpoint, open CORS, no key. Fetch any record programmatically and recompute its hash yourself.
For platforms
Register and update YOUR records programmatically with a service key, instead of through the form. Built for integrators, marketplaces and moderation.
Claims
How to claim a record that refers to you or your avatar, and what happens after you submit a claim.
Glossary
Avatar, voice clone, agent, deployer, provider, AI Act Article 50, C2PA, deepfake, KYC, content hash, anteriority: the vocabulary, defined plainly.
How the registry works, in four steps
Section titled “How the registry works, in four steps”Whatever page you land on, the mental model is the same. A record is born from a declaration, gets sealed, stays private to you, and becomes public only if you verify it.
- Declare. You state that an avatar is yours and that you take responsibility for it. That declaration is the heart of the record.
- Seal. The moment you submit, the database assigns a sequential THB number, stamps the exact registration time in UTC, and computes a SHA-256 content hash of your registration snapshot. The number and the date are immutable from then on; the hash follows your content, and every version is archived.
- Keep it private. You get your THB number, a receipt and a private page only you can see, with the green Registered seal. At the free level the record is not listed in the directory and has no public URL.
- Verify (optional). Once it opens you can add an identity check and upgrade to the gold Verified seal. That is the step that makes a record public, giving it a page at its own URL, a listing in the directory and an API entry. See Verification.
The two levels at a glance
Section titled “The two levels at a glance”| Level | Seal | What it is | Availability |
|---|---|---|---|
| Registered | A private self-declaration with a tamper-proof date: “this avatar is mine and I answer for it”. | Free, available now | |
| Verified | Adds an identity check confirming a real human is behind the record. | Not open yet |
The word rule is strict: the free level is always called Registered, never “verified”. The gold seal is earned through the identity check. Neither seal is an official certification or a public accreditation: TheHumanBehind is an independent, private registry.
Suggested reading order
Section titled “Suggested reading order”If you are new, read the pages in this order. Each one ends with a link to the next, so you can move straight through.
- Getting started: create an account and publish your first record.
- Records: the fields, the number, and the exact content-hash recipe.
- Directory: how to search and read records.
- Verification: the gold level.
- Public API: consult and verify records programmatically.
- Claims and Glossary: reference material.
Conventions used in these docs
Section titled “Conventions used in these docs”| Convention | Meaning |
|---|---|
monospace |
A literal value, field name or code, exactly as it appears in the data or the API (for example content_hash or voice_clone). |
THB-2026-00117 |
The format of a THB registry number: the prefix, the year of registration, and a sequential number zero-padded to a minimum of five digits (more, if a year ever passed 99,999 records). |
2026-07-14T09:21:33.481205Z |
A timestamp, always ISO-8601 in UTC (the trailing Z), with microsecond precision. |
/r/<slug> |
The public URL of a record. The slug is its short, immutable identifier. |
Frequently asked
Section titled “Frequently asked”Is it free?
Section titled “Is it free?”Yes. Creating an account, registering an avatar and keeping it registered are free. Only the optional Verified level, which is not open yet, has a cost.
Is my email address public?
Section titled “Is my email address public?”No. Your email is used only to manage your account. It is never part of a record, never shown on a record page and never returned by the API.
Does registering make me compliant with the law?
Section titled “Does registering make me compliant with the law?”No, and we never claim it does. The EU AI Act asks for transparency about AI content; registering here gives you a dated, tamper-proof record of who answers for an avatar, which helps you demonstrate accountability. It does not, by itself, fulfil a legal obligation.
Is TheHumanBehind an official registry?
Section titled “Is TheHumanBehind an official registry?”No. It is an independent, private registry. Neither seal is a government certification or a public accreditation.
Can I remove a record later?
Section titled “Can I remove a record later?”Yes. You can unpublish a record at any time. It stops being listed and its API entry disappears, but its page keeps a dated notice so the trace is never silently rewritten, and its THB number is never reused.
What if you shut down?
Section titled “What if you shut down?”We’ve made a public commitment: six months’ notice, a complete open dump of every public record, and no selling the database to a third party without that dump first. Read the full commitment in the Trust Center.
Quick links
Section titled “Quick links”- Create your free account on the registry platform.
- Search the registry, open to everyone.
- Security: how the registry protects your data, in plain words.