Developer Tools & API

Privacy-First Credential Management • SD-JWT Playground • Enterprise-Grade APIs

🚀 Quick Start Guide

Get started with Aletheia AI in 3 simple steps. From authentication to your first auditable AI decision.

⚡ 5 minutes setup🔐 Enterprise-grade security📚 Multiple languages

Authentication

# 1. Login and get session token
curl -X POST http://localhost:8081/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-email@example.com",
    "password": "your-password"
  }'

# Response:
# {
#   "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
#   "user": { ... }
# }

# 2. Use token in subsequent requests
export TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

curl http://localhost:8081/api/v1/agents \
  -H "Authorization: Bearer $TOKEN"

Register AI Agent

Create your first AI agent with identity, capabilities, and compliance settings. Receive a cryptographically signed birth certificate.

# Register a new AI agent
curl -X POST http://localhost:8081/api/v1/agents \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GPT-4 Assistant",
    "agentType": "CONVERSATIONAL",
    "riskClassification": "high",
    "capabilities": ["text_generation", "qa"],
    "primaryJurisdiction": "EU",
    "dataRetentionDays": 90
  }'

# Response:
# {
#   "agentId": "urn:uuid:agent-123...",
#   "name": "GPT-4 Assistant",
#   "status": "active",
#   "birthCertificateUrl": "/certificates/agent-123.pdf"
# }

Log AI Decision

Log every AI decision with cryptographic proof (RSA + ML-DSA), RFC 3161 timestamp, and immutable audit trail. Download evidence packages for legal proceedings.

# Log an AI decision with cryptographic signature
curl -X POST http://localhost:8081/api/v1/audit/events \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "urn:uuid:agent-123...",
    "eventType": "DECISION_MADE",
    "action": "loan_approval",
    "resource": "application/loan-12345",
    "outcome": "SUCCESS",
    "metadata": {
      "loanAmount": 50000,
      "creditScore": 720,
      "decision": "approved"
    },
    "riskLevel": "HIGH"
  }'

# Response includes cryptographic proof:
# {
#   "id": "84739",
#   "timestamp": "2026-02-12T15:30:00Z",
#   "timestampProof": "eyJ0eXAiOiJKV1QiLCJhbGc...",  # RFC 3161
#   "blockchainAnchor": "0x1a2b3c..."
# }

🎯 Next Steps

📚

Full API Reference

Explore all endpoints with Swagger UI

🧪

Try Sandbox

Test agents in safe environment

🎯

Use Cases

Real-world implementation examples

🎨 UI Component LibraryNew

Unified, accessible, and consistent UI components built with Tailwind CSS and React. All components support dark mode, keyboard navigation, and ARIA attributes.

Buttons

Badges

DefaultSuccessWarningErrorInfoCritical RiskHigh RiskMedium RiskLow RiskActiveRevoked

Alerts

Information

This is an informational alert with default styling.

Success

Your operation completed successfully!

Warning

Please review this information carefully.

Error

An error occurred while processing your request.

Form Components

import { Button, Input, Badge, Alert } 
from "@/app/components/ui";

<Button variant="primary">
  Click me
</Button>

Loading & Error States

Failed to load data

Components

100%

Dark Mode

WCAG AA

Accessible

TypeScript

Fully Typed

📦 Official SDKs & Tools

Choose your preferred language and get started in minutes. All SDKs include authentication, error handling, and full TypeScript support.

🐍

Python SDK

pip install aletheia-ai

✓ Python 3.8+

✓ Type hints

✓ Async support

📦

JavaScript SDK

npm install @aletheia/sdk

✓ Node.js 16+

✓ TypeScript

✓ Browser support

⌨️

CLI Tool

npm install -g aletheia-cli

✓ Cross-platform

✓ Interactive prompts

✓ Scriptable

📮Postman Collection

Import all API endpoints into Postman with pre-configured examples and authentication.

📥Download OpenAPI Spec

🚀 Build Privacy-First AI Applications

Aletheia empowers developers to create trustworthy AI systems with selective disclosure, cryptographic proof, and automatic GDPR compliance. Share only what's necessary, when it's necessary.

You can clear browser localStorage to see it again

🔒

Privacy by Default

Zero-knowledge proofs & selective disclosure built-in

⚡

5min Integration

RESTful APIs with SDKs for Python, TypeScript, Go

📊

Full Audit Trail

Every disclosure logged for compliance & analytics

🏆

EU AI Act Ready

Built-in compliance with GDPR, eIDAS 2.0, AI Act

Status…

ℹNo agents found. Register an agent first at /agents or switch to Demo Mode to explore features.

🎯 Step 1: Select Agent & Credential

Choose which AI agent and credential you want to work with. Credentials contain verifiable claims that can be selectively disclosed.

✓Each agent can have multiple credentials with different claim sets

✓SD-JWT credentials support selective disclosure of individual attributes

✓All credentials are cryptographically signed and tamper-proof

Select Agent

No agents available

Select Credential

No credentials found.Issue one first →

🎯 SD-JWT Selective Disclosure Playground

Selective Disclosure lets you share only the specific data needed for each verification. Built with SD-JWT for cryptographic proof while minimizing data exposure.

✓ Privacy by Design

GDPR Article 5(1)(c)

✓ Audit Trail

Every disclosure logged

✓ Cryptographic Proof

Zero-knowledge verification

Verifier Information

Verifier ID (DID)

Verifier Name

Purpose (Required for GDPR)

Select Claims to Disclose

ℹ️

💡 Choose which claims to share. Fewer selections = higher privacy score.

No claims available. Select an agent and credential first.

💼 Why This Matters for Your Business

• Reduce Legal Risk: Minimize data exposure = minimize liability
• Build Trust: Users appreciate privacy-first design
• GDPR Compliance: Automatic data minimization documentation
• Competitive Edge: Privacy as a differentiator

Privacy Score

ℹ️

100/100

Excellent Privacy

🏆 Best Practice

🎉 Outstanding! You're protecting user privacy while maintaining trust.

✨ Build user trust and competitive advantage

📋 Compliant with GDPR Article 5(1)(c) - Data Minimization

Disclosure Summary

ℹ️

📊 Total Claims:0

🔓 Disclosing:0

🔒 Keeping Private:0

👈

Select at least one claim to preview

📋 Use Case Examples

🏥

Insurance Verification

Minimal disclosure for insurance eligibility check

Disclosed: riskLevel, insurance.coverage

Hidden: personalInfo.*, insurance.policyNumber

Privacy Score: 85/100

🔍

Full Compliance Audit

Complete disclosure for regulatory audit

Disclosed: All claims

Hidden: None

Privacy Score: 0/100

🕵️

Anonymous Analysis

Zero personal data disclosure

Disclosed: agentType, riskLevel, certifications.*

Hidden: personalInfo.*, insurance.*

Privacy Score: 95/100

💻 SDK Examples

Python SDK

import requests

# Preview disclosure
response = requests.post(
    "http://localhost:8081/api/v1/disclosures/preview",
    json={
        "credentialId": "urn:uuid:12345...",
        "verifierId": "did:web:insurance-provider.eu",
        "verifierName": "ACME Insurance Co.",
        "claimsToDisclose": ["riskLevel", "insurance.coverage"],
        "purpose": "Insurance eligibility verification",
        "consentGiven": True
    }
)

preview = response.json()
print(f"Privacy Score: {preview['privacyScore']}")
print(f"Presentation: {preview['presentation']}")

# Create actual disclosure (logs to audit trail)
disclosure = requests.post(
    "http://localhost:8081/api/v1/disclosures/present",
    json={...}  # Same payload as preview
)

print(f"Disclosure ID: {disclosure.json()['disclosureId']}")

TypeScript/JavaScript SDK

import axios from 'axios';

interface DisclosureRequest {
  credentialId: string;
  verifierId: string;
  verifierName: string;
  claimsToDisclose: string[];
  purpose: string;
  consentGiven: boolean;
}

const request: DisclosureRequest = {
  credentialId: "urn:uuid:12345...",
  verifierId: "did:web:insurance-provider.eu",
  verifierName: "ACME Insurance Co.",
  claimsToDisclose: ["riskLevel", "insurance.coverage"],
  purpose: "Insurance eligibility verification",
  consentGiven: true
};

// Preview
const preview = await axios.post(
  'http://localhost:8081/api/v1/disclosures/preview',
  request
);

console.log(`Privacy Score: ${preview.data.privacyScore}`);
console.log(`Compliance: ${preview.data.complianceFlags.join(', ')}`);

// Create disclosure
const disclosure = await axios.post(
  'http://localhost:8081/api/v1/disclosures/present',
  request
);

console.log(`Disclosure ID: ${disclosure.data.disclosureId}`);

cURL

# Preview disclosure
curl -X POST http://localhost:8081/api/v1/disclosures/preview \
  -H "Content-Type: application/json" \
  -d '{
    "credentialId": "urn:uuid:12345...",
    "verifierId": "did:web:insurance-provider.eu",
    "verifierName": "ACME Insurance Co.",
    "claimsToDisclose": ["riskLevel", "insurance.coverage"],
    "purpose": "Insurance eligibility verification",
    "consentGiven": true
  }'

# Create disclosure (logs to audit trail)
curl -X POST http://localhost:8081/api/v1/disclosures/present \
  -H "Content-Type: application/json" \
  -d '{...}'  # Same payload

# Get disclosure history
curl http://localhost:8081/api/v1/disclosures/history/urn:uuid:agent-67890

# Get disclosure statistics
curl http://localhost:8081/api/v1/disclosures/stats/urn:uuid:agent-67890

📚 API Endpoints

POST/api/v1/disclosures/preview

Preview what would be disclosed without creating audit record

POST/api/v1/disclosures/present

Create and log disclosure (permanent audit record)

GET/api/v1/disclosures/history/:agentId

Get complete disclosure audit trail for an agent

GET/api/v1/disclosures/stats/:agentId

Get disclosure statistics and analytics

← Back to Home

Phase 6.5.2 - Disclosure API & Developer Tools

# 1. Login and get session token curl -X POST http://localhost:8081/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{ "email": "your-email@example.com", "password": "your-password" }' # Response: # { # "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", # "user": { ... } # } # 2. Use token in subsequent requests export TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." curl http://localhost:8081/api/v1/agents \ -H "Authorization: Bearer $TOKEN"

# Register a new AI agent curl -X POST http://localhost:8081/api/v1/agents \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "GPT-4 Assistant", "agentType": "CONVERSATIONAL", "riskClassification": "high", "capabilities": ["text_generation", "qa"], "primaryJurisdiction": "EU", "dataRetentionDays": 90 }' # Response: # { # "agentId": "urn:uuid:agent-123...", # "name": "GPT-4 Assistant", # "status": "active", # "birthCertificateUrl": "/certificates/agent-123.pdf" # }

# Log an AI decision with cryptographic signature curl -X POST http://localhost:8081/api/v1/audit/events \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "agentId": "urn:uuid:agent-123...", "eventType": "DECISION_MADE", "action": "loan_approval", "resource": "application/loan-12345", "outcome": "SUCCESS", "metadata": { "loanAmount": 50000, "creditScore": 720, "decision": "approved" }, "riskLevel": "HIGH" }' # Response includes cryptographic proof: # { # "id": "84739", # "timestamp": "2026-02-12T15:30:00Z", # "timestampProof": "eyJ0eXAiOiJKV1QiLCJhbGc...", # RFC 3161 # "blockchainAnchor": "0x1a2b3c..." # }

📦 Official SDKs & Tools

Choose your preferred language and get started in minutes. All SDKs include authentication, error handling, and full TypeScript support.

🐍

Python SDK

pip install aletheia-ai

✓ Python 3.8+

✓ Type hints

✓ Async support

📦

JavaScript SDK

npm install @aletheia/sdk

✓ Node.js 16+

✓ TypeScript

✓ Browser support

⌨️

CLI Tool

npm install -g aletheia-cli

✓ Cross-platform

✓ Interactive prompts

✓ Scriptable

📮Postman Collection

Import all API endpoints into Postman with pre-configured examples and authentication.

📥Download OpenAPI Spec

📋 Use Case Examples

🏥

Insurance Verification

Minimal disclosure for insurance eligibility check

Disclosed: riskLevel, insurance.coverage

Hidden: personalInfo.*, insurance.policyNumber

Privacy Score: 85/100

🔍

Full Compliance Audit

Complete disclosure for regulatory audit

Disclosed: All claims

Hidden: None

Privacy Score: 0/100

🕵️

Anonymous Analysis

Zero personal data disclosure

Disclosed: agentType, riskLevel, certifications.*

Hidden: personalInfo.*, insurance.*

Privacy Score: 95/100

💻 SDK Examples

Python SDK

import requests

# Preview disclosure
response = requests.post(
    "http://localhost:8081/api/v1/disclosures/preview",
    json={
        "credentialId": "urn:uuid:12345...",
        "verifierId": "did:web:insurance-provider.eu",
        "verifierName": "ACME Insurance Co.",
        "claimsToDisclose": ["riskLevel", "insurance.coverage"],
        "purpose": "Insurance eligibility verification",
        "consentGiven": True
    }
)

preview = response.json()
print(f"Privacy Score: {preview['privacyScore']}")
print(f"Presentation: {preview['presentation']}")

# Create actual disclosure (logs to audit trail)
disclosure = requests.post(
    "http://localhost:8081/api/v1/disclosures/present",
    json={...}  # Same payload as preview
)

print(f"Disclosure ID: {disclosure.json()['disclosureId']}")

TypeScript/JavaScript SDK

import axios from 'axios';

interface DisclosureRequest {
  credentialId: string;
  verifierId: string;
  verifierName: string;
  claimsToDisclose: string[];
  purpose: string;
  consentGiven: boolean;
}

const request: DisclosureRequest = {
  credentialId: "urn:uuid:12345...",
  verifierId: "did:web:insurance-provider.eu",
  verifierName: "ACME Insurance Co.",
  claimsToDisclose: ["riskLevel", "insurance.coverage"],
  purpose: "Insurance eligibility verification",
  consentGiven: true
};

// Preview
const preview = await axios.post(
  'http://localhost:8081/api/v1/disclosures/preview',
  request
);

console.log(`Privacy Score: ${preview.data.privacyScore}`);
console.log(`Compliance: ${preview.data.complianceFlags.join(', ')}`);

// Create disclosure
const disclosure = await axios.post(
  'http://localhost:8081/api/v1/disclosures/present',
  request
);

console.log(`Disclosure ID: ${disclosure.data.disclosureId}`);

cURL

# Preview disclosure
curl -X POST http://localhost:8081/api/v1/disclosures/preview \
  -H "Content-Type: application/json" \
  -d '{
    "credentialId": "urn:uuid:12345...",
    "verifierId": "did:web:insurance-provider.eu",
    "verifierName": "ACME Insurance Co.",
    "claimsToDisclose": ["riskLevel", "insurance.coverage"],
    "purpose": "Insurance eligibility verification",
    "consentGiven": true
  }'

# Create disclosure (logs to audit trail)
curl -X POST http://localhost:8081/api/v1/disclosures/present \
  -H "Content-Type: application/json" \
  -d '{...}'  # Same payload

# Get disclosure history
curl http://localhost:8081/api/v1/disclosures/history/urn:uuid:agent-67890

# Get disclosure statistics
curl http://localhost:8081/api/v1/disclosures/stats/urn:uuid:agent-67890

📚 API Endpoints

POST/api/v1/disclosures/preview

Preview what would be disclosed without creating audit record

POST/api/v1/disclosures/present

Create and log disclosure (permanent audit record)

GET/api/v1/disclosures/history/:agentId

Get complete disclosure audit trail for an agent

GET/api/v1/disclosures/stats/:agentId

Get disclosure statistics and analytics