top of page
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.

​

  1. Create a RapidAPI account.

  2. Subscribe to the MilliHash BASIC plan. It's free and includes 25 registrations a month, project versions included.

  3. 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.

bottom of page