REST API · REGISTRATION PIPELINE

TruthSource API Reference

Welcome to the TruthSource API. Our RESTful architecture empowers enterprise teams to integrate provenance protocol + AI analysis directly into their existing workflows.

01

Security & Authentication

📄 Data handling

Data handling: the /notarize and /verify endpoints work with the SHA-256 hash that you calculate on your side. Your original file is not sent unless you use a feature that analyzes file content (for example AI forensic analysis); in that case the file is uploaded to our cloud storage as described in the Privacy Policy.

🔑 Authentication

Authenticate your API requests via Bearer Tokens. Include your secret key in the header:

http
Authorization: Bearer tsk_live_YOUR_KEY
02

Core Endpoints

All endpoints accept JSON payloads and return standard HTTP response codes.

POST
/notarize

Registers the hash of a digital asset on the Polygon blockchain. Embeds provenance metadata (C2PA-style, unsigned) in JPEG/PNG files.

POST
/verify

Verifies a file's hash against the blockchain ledger.

POST
/status

Retrieves the real-time processing and AI-forensic status of a specific record by its ID.

POST
/list

Returns a paginated list of all certified assets associated with your API key.

03

API Sandbox

Run a request without leaving the page. The sandbox hashes locally and returns an illustrative payload in the exact shape the live API responds with.

truthsource — api sandboxSIMULATION
bash
curl -X POST https://truthsource-pro.base44.app/api/functions/apiGateway \
  -H "Authorization: Bearer tsk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "endpoint": "notarize",
        "hash": "<sha256-of-your-asset>",
        "author": "reuters.com",
        "fileType": "image/jpeg" }'
Runs locally. No key needed, no quota consumed, no record created.
04

Webhooks & Asynchronous Processing

Blockchain anchoring requires confirmation time. Use our Webhooks to receive real-time POST alerts to your endpoint when an asset's certification is completed or if an AI-forensic anomaly is detected.

05

Rate Limits

API
Rate limit: 60 requests per minute per API key.

Monthly quota is set per API key (default 1,000 requests). Contact us for higher volumes and custom terms.

Contact sales for provisioning.

Privacy: only the file's hash is published on the blockchain. Files are uploaded to our cloud storage for verification and AI analysis and remain there until deleted. See the Privacy Policy for retention and your rights.