API Reference

Developer Documentation

Integrate operational trust into your application. Hash a document, POST it, get a permanent independently verifiable proof.

Quick Start

# 1. Hash your document

sha256sum your-document.pdf


# 2. Submit for notarization

curl -X POST https://your-tlt-host/api/notarize \

-H "Authorization: Bearer YOUR_API_KEY" \

-d '{"document_hash":"<sha256>","source":"human"}'


# 3. Verify from anywhere

curl https://your-tlt-host/api/public/verify/<proof_id>

The verify endpoint requires no authentication. Share the proof ID — anyone can verify it.

Public Verification

No authentication required. Open to any caller.

GET/api/public/trust/{proofId}Full trust view for a proof — visibility-gated
GET/api/public/verify/{proofId}Machine-readable trust status (TLT-authoritative)
GET/api/public/qr/{proofId}QR code PNG pointing to the verification page
GET/api/public/snapshot/{snapshotHash}Snapshot replay verification result
GET/api/public/qr/snapshot/{hash}QR code for snapshot verification page
GET/api/public/certificate/{proofId}Certificate PDF (redirects to download)
GET/api/public/package/{proofId}Evidence package ZIP (redirects to download)

Notarization

Requires Bearer API key.

POST/api/notarizeSubmit a document hash for notarization
GET/api/notarize/{id}/statusPoll async notarization progress
GET/api/verify/{txid}Retrieve proof details by transaction ID

Evidence

Requires Bearer API key.

GET/api/evidence-package/{txid}Download full evidence ZIP (PDF + JSON + chain)
GET/api/certificate/{txid}Download PDF certificate
GET/api/evidence-chain/{txid}Retrieve provenance chain
GET/api/graph/{id}Full provenance graph (nodes, edges, timeline, risk)

Webhooks

Requires Bearer API key.

POST/api/webhooksRegister a webhook endpoint
GET/api/webhooksList webhook subscriptions
DELETE/api/webhooks/{id}Remove a webhook subscription

Webhook Events

Subscribe to receive real-time notifications for operational events.

notarization.confirmed
notarization.failed
notarization.revoked
workflow.completed
workflow.approved
workflow.rejected

Ready to integrate?

Request an API key to get started. Full integration guide included.

Request API Access