Developer Portal
Veracity101 provides the immutable evidence infrastructure for legal-tech, compliance, and ESG workflows. Ingest any file, secure it instantly with a cryptographic seal, and analyze its integrity using the Evidence Gravity Score (EGS). Ship share-safe compliance data via PDECs (Partial-Disclosure Evidence Capsules).
Once approved for developer access, you'll receive API credentials to authenticate your requests:
export VERACITY101_API_KEY='sk_live_your_key_here'Use the /api/ingest endpoint to seal any document (PDF, DOCX, image, JSON) immediately. This process generates an immutable hash and the complete Source Authentication record.
// Step 1: Ingest and Seal a Document
import fs from "fs";
import FormData from "form-data";
import fetch from "node-fetch";
const API_KEY = process.env.VERACITY101_API_KEY;
const INGEST_URL = "https://api.veracity101.com/api/ingest";
async function ingestAndScore(filePath) {
const form = new FormData();
form.append("file", fs.createReadStream(filePath));
// 1. Ingest and seal the file
let res = await fetch(INGEST_URL, {
method: "POST",
headers: { Authorization: `Bearer ${API_KEY}` },
body: form,
});
const ingestData = await res.json();
const vaultId = ingestData.id;
console.log(`Sealed ID: ${vaultId}. Hash: ${ingestData.hash.slice(0, 8)}...`);
// 2. Run EGS Scan for risk analysis
res = await fetch("https://api.veracity101.com/api/evidence/egs", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${API_KEY}`,
},
body: JSON.stringify({ id: vaultId }),
});
const egsData = await res.json();
console.log(`EGS Scan Complete. Risk Score: ${egsData.egs.riskScore}`);
// 3. Generate a share-safe PDEC
res = await fetch("https://api.veracity101.com/api/evidence/pdec", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${API_KEY}`,
},
body: JSON.stringify({ id: vaultId }),
});
const pdecData = await res.json();
console.log(`PDEC Created: ${pdecData.exportUrl}`);
}import requests
import os
VAULT_ID = "vault_9c83ba"
# Use the full provenance document retrieval
res = requests.get(
f"https://api.veracity101.com/api/document/{VAULT_ID}",
headers={"Authorization": f"Bearer {os.environ['VERACITY101_API_KEY']}"}
)
doc = res.json()
print(f"File: {doc['filename']}")
print(f"Sealed Hash: {doc['hash'][:10]}...")
# Crucial Source Authentication check
if 'ipAnalysis' in doc and doc['ipAnalysis'] == 'Anonymizing Proxy':
print("\n⚠️ WARNING: SOURCE AUTHENTICATION FLAG!")
print(f"Upload Source: {doc['uploadIP']} ({doc['geoCountry']})")
print(f"Risk Type: {doc['ipAnalysis']}")
else:
print("\n✅ Source Integrity Check: Verified Residential ISP.")For continuous security validation and regulatory compliance (e.g., ISO 27001), use Webhooks to send lifecycle events to your Enginsight SIEM/Log Management system.
Triggers an audit log entry in Enginsight, connecting the file's immutable seal time with your platform's security monitoring logs, providing a defensible security chain-of-custody.