DOCS
Getting Started
Verify a record in under a minute, with no sign-up. Then get a free API key and make your first registration.
1. Try it, no sign-up
Verification is free and open to everyone. MilliHash registered a sample text you can check right now. First, fetch it:
Then send that text back to be verified:
curl -X POST https://api.millihash.com/verify \
-H "Content-Type: application/json" \
-d '{"contentType": "text", "text": "PASTE THE SAMPLE TEXT HERE"}'
The response shows when the text was registered and by which timestamp authority. Change even one character and you'll get no match.
Prefer not to use the command line? Drop a file into the web app to check it.
2. Get a free API key
Registering assets requires an API key, which MilliHash issues through RapidAPI.
-
Subscribe to the MilliHash BASIC plan. It's free and includes 25 registrations a month, project versions included.
-
Copy your key from the X-RapidAPI-Key field on any endpoint page.
Every authenticated request carries two headers:
X-RapidAPI-Key: YOUR_API_KEY
X-RapidAPI-Host: millihash.p.rapidapi.com
You can also test any endpoint in your browser from RapidAPI. Its Code Snippets tab shows the same call in your language of choice.
3. Your first registration
Register a short piece of text:
curl -X POST https://millihash.p.rapidapi.com/registrations \
-H "X-RapidAPI-Key: YOUR_API_KEY" \
-H "X-RapidAPI-Host: millihash.p.rapidapi.com" \
-H "Content-Type: application/json" \
-d '{"submissionMode": "server-computed", "contentType": "text",
"text": "My first MilliHash registration", "label": "Hello world"}'
To register a file instead, send it as a form upload:
curl -X POST https://millihash.p.rapidapi.com/registrations \
-H "X-RapidAPI-Key: YOUR_API_KEY" \
-H "X-RapidAPI-Host: millihash.p.rapidapi.com" \
-F "submissionMode=server-computed" \
-F "label=Chapter 1 draft" \
-F "file=@chapter-01.docx"
The response comes back right away with the asset's SHA-256 hash, the timestamp authority's signed time, and a link to its certificate:
{
"registrationId": "cb67e1cd-0e53-4115-9a51-243e5b471e8b",
"hash": "9f2c41d8...5c3a7a1e",
"submissionMode": "server-computed",
"tsaTimestamp": "2026-10-30T19:42:17.381Z",
"tsaProvider": "...",
"certificateUrl": "/certificates/..."
}
4. After you register
Your record is protected by two independent layers:
-
Immediately: a timestamp authority signs the hash. You can download the standard certificate right away.
-
Within a few hours: the hash is anchored to the Bitcoin blockchain through OpenTimestamps. Once confirmed, the Bitcoin-anchored certificate and the .ots proof file become available.
Check anchoring progress. This call is free and needs no key:
The state moves from Pending to Confirmed. Polling every few minutes is plenty. Then download both certificates with your key:
Certificate
Endpoint
Available
Standard (timestamp authority)
Bitcoin-anchored
GET /certificates/{id}
GET /certificates/{id}/anchored
Immediately
Once confirmed
5. Track versions with projects
A project groups the versions of one work. Each version is cryptographically linked to the one before it, so the order of your drafts becomes part of the record.
Create a project with its first version, using the same body as a registration:
curl -X POST https://millihash.p.rapidapi.com/projects \
-H "X-RapidAPI-Key: YOUR_API_KEY" \
-H "X-RapidAPI-Host: millihash.p.rapidapi.com" \
-F "submissionMode=server-computed" \
-F "label=Novel manuscript" \
-F "file=@draft-1.docx"
Add the next version. Pass the current version's contentHash from the previous response, so a version can't be appended out of order:
curl -X POST https://millihash.p.rapidapi.com/projects/PROJECT_ID/versions \
-H "X-RapidAPI-Key: YOUR_API_KEY" \
-H "X-RapidAPI-Host: millihash.p.rapidapi.com" \
-H "X-Project-Head-Content-Hash: CURRENT_CONTENT_HASH" \
-F "submissionMode=server-computed" \
-F "file=@draft-2.docx"
Anyone can confirm the chain is intact, with no key:
6. Keep files private
MilliHash never stores your files, only their hashes. For complete privacy, compute the SHA-256 hash on your own device and send just the hash. The file never leaves your machine, and there's no upload size limit.
# macOS / Linux
shasum -a 256 chapter-01.docx
curl -X POST https://millihash.p.rapidapi.com/registrations \
-H "X-RapidAPI-Key: YOUR_API_KEY" \
-H "X-RapidAPI-Host: millihash.p.rapidapi.com" \
-H "Content-Type: application/json" \
-d '{"submissionMode": "client-supplied", "documentHash": "YOUR_SHA256_HEX"}'
To verify later, compute the hash again and look it up with:
curl -X GET /certificates/{hash}/verify
7. Plan limits
Registrations, new projects, and new versions each count as one registration. Reading your records, downloading certificates, and verification don't count.
Plan
Price / month
Registrations / month
Max upload size / asset
BASIC
PRO
ULTRA
MEGA
Free
$9
$29
$99
25
150
600
3,000
10 MB
25 MB
25 MB
100 MB
Hashes you compute yourself have no size limit. Verification calls sent to api.millihash.com are free and don't count toward your plan. See Pricing for overage rates.