H33 API Documentation

Quick Start

Get started in 3 steps

1

Get API Key

Sign up for free trial (500 credits, 60 days)

2

Install SDK

npm install @h33/client

3

Make First Call

Full post-quantum auth in one line

JavaScript

// Install: npm install @h33/client

import { H33 } from '@h33/client';

const h33 = new H33('h33_live_xxx');

// Full post-quantum auth: 15 credits, 220µs
const result = await h33.auth.fullStack({
  userId: 'user_123',
  biometric: faceData,
  mode: 'turbo'
});

console.log(result);
// {
//   match: true,
//   confidence: 0.9847,
//   zkProof: "0x...",
//   quantumSignature: "0x...",
//   blockchainTx: "5KtP...",
//   latency: "218µs"
// }
                    

Authentication

All API requests require authentication using your API key in the Authorization header.

HTTP Header

Authorization: Bearer h33_live_xxxxxxxxxxxxxxxxxxxx

ℹ️

API Key Types

h33_live_* - Production keys, full access
h33_test_* - Test keys, sandbox environment (no credits consumed)

Key Management

API keys can be created, rotated, and revoked from your dashboard. We recommend:

Using different keys for different environments
Rotating keys every 90 days
Never committing keys to version control

Pricing & Credits

H33 uses a credit-based pricing model. Buy credits, use them for any operation. Credits never expire. 20% off with annual prepay.

Starter

$299

8,000 credits

$0.0374/credit

Growth

$899

25,000 credits

$0.0360/credit

Business

$2,499

70,000 credits

$0.0357/credit

Scale

$7,999

225,000 credits

$0.0356/credit

🎁

Free Trial

500 free credits • 60 days • 50 credits/day limit • Full API access

Credit Costs by Operation

Choose your speed tier based on latency requirements:

Operation	Turbo (220µs)	Standard (633µs)	Precision (2.1ms)
Full Stack Auth	15	8	12
Biometric Verify	3	1.5	2
Biometric Enroll	5	3	4
FHE Encrypt/Decrypt	3	1.5	2
ZK Proof Generate	8	5	6
ZK Proof Verify	2	1	1.5
Quantum Sign/Verify	3	2	2
Blockchain Tx	1	1	1

KYC / Identity (Fixed Pricing)

Service	Price	Includes
KYC Basic + SBT	$49	ID, Selfie, Liveness, Soulbound NFT
KYC Enhanced + SBT	$79	+ Proof of Address verification
AML/PEP Screening	$19	Sanctions, PEP, Adverse Media
Full Bundle	$99	KYC + AML + Soulbound NFT

Full Stack Auth

POST /auth/full-stack PATENT PENDING

Complete post-quantum authentication in a single call. Combines FHE-encrypted biometric matching, zero-knowledge proof generation, quantum-resistant signature, and blockchain attestation.

220µs

Turbo Latency

15 credits

Turbo Cost

99.7%

Accuracy

5 layers

Security

Request Body

Parameter	Type	Required	Description
`userId`	string	Required	Unique identifier for the user
`biometric`	object	Required	Biometric data (face, voice, or fingerprint)
`biometric.type`	string	Required	"face" \| "voice" \| "fingerprint"
`biometric.data`	string	Required	Base64-encoded biometric data
`mode`	string	Optional	"turbo" (220µs) \| "standard" (633µs) \| "precision" (2.1ms). Default: "standard"
`zkClaims`	object	Optional	Additional claims to include in ZK proof
`blockchain`	object	Optional	Blockchain attestation options

Example Request

cURL

curl -X POST https://api.h33.ai/v1/auth/full-stack \
  -H "Authorization: Bearer h33_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_123",
    "biometric": {
      "type": "face",
      "data": "base64_encoded_face_data..."
    },
    "mode": "turbo",
    "zkClaims": {
      "ageOver": 18,
      "country": "US"
    },
    "blockchain": {
      "network": "solana",
      "mintSbt": true
    }
  }'
                            

Example Response

JSON

{
  "success": true,
  "match": true,
  "confidence": 0.9847,
  "zkProof": {
    "proof": "0x1a2b3c...",
    "publicInputs": ["0x..."],
    "verificationKey": "0x..."
  },
  "quantumSignature": {
    "algorithm": "dilithium3",
    "signature": "0x4d5e6f...",
    "publicKey": "0x..."
  },
  "blockchain": {
    "network": "solana",
    "txHash": "5KtPn...",
    "sbtMint": "H33sbt..."
  },
  "metadata": {
    "latency": "218µs",
    "mode": "turbo",
    "creditsUsed": 15
  }
}
                            

Biometric Enroll

POST /biometric/enroll

Enroll a new biometric template. The template is encrypted using FHE before storage - we never see or store raw biometric data.

5 credits

Turbo Cost

3 types

Face, Voice, Fingerprint

Request Body

Parameter	Type	Required	Description
`userId`	string	Required	Unique identifier for the user
`biometric`	object	Required	Biometric data to enroll
`biometric.type`	string	Required	"face" \| "voice" \| "fingerprint"
`biometric.data`	string	Required	Base64-encoded biometric data
`mode`	string	Optional	"turbo" \| "standard" \| "precision"

JavaScript

const enrollment = await h33.biometric.enroll({
  userId: 'user_123',
  biometric: {
    type: 'face',
    data: faceImageBase64
  },
  mode: 'turbo'
});

// { enrollmentId: "enr_xxx", templateHash: "0x...", status: "active" }
                            

Biometric Verify

POST /biometric/verify POPULAR

Verify a biometric sample against an enrolled template. Matching is performed entirely on encrypted data using FHE - the raw biometric never leaves your device.

220µs

Turbo Latency

3 credits

Turbo Cost

99.7%

Accuracy

JavaScript

const result = await h33.biometric.verify({
  userId: 'user_123',
  biometric: {
    type: 'face',
    data: currentFaceBase64
  },
  mode: 'turbo'
});

// { match: true, confidence: 0.9847, latency: "218µs" }
                            

FHE Encryption

POST /fhe/encrypt

Encrypt data using Fully Homomorphic Encryption. Encrypted data can be processed without decryption, enabling privacy-preserving computation.

150µs

Encrypt Latency

3 credits

Turbo Cost

FHE Modes

Mode	Latency	Parameter N	Use Case
Turbo	220µs	N=1,024	Real-time auth, high throughput
Standard	633µs	N=4,096	General purpose (default)
Precision	2.1ms	N=16,384	Maximum security, complex ops

JavaScript

const encrypted = await h33.fhe.encrypt({
  data: sensitiveData,
  mode: 'turbo',
  scheme: 'bfv'  // or 'ckks' for floating point
});

// { ciphertext: "0x...", publicKey: "0x...", metadata: {...} }
                            

FHE Compute

POST /fhe/compute

Perform computations on encrypted data. Supports addition, multiplication, comparison, and custom operations without ever decrypting.

JavaScript

// Compare encrypted biometric templates
const result = await h33.fhe.compute({
  operation: 'euclidean_distance',
  inputs: [encryptedTemplate1, encryptedTemplate2],
  mode: 'turbo'
});

// Result is still encrypted - decrypt on client side
                            

Zero-Knowledge Proofs

POST /zkp/prove

Generate a zero-knowledge proof. Prove statements about your data without revealing the data itself. Supports Groth16, PLONK, and custom R1CS circuits.

267µs

Cached Circuit

8 credits

Turbo Cost

Supported Proof Types

Scheme	Proof Size	Verify Time	Notes
KZG (Groth16)	~200 bytes	~3ms	Smallest proofs, trusted setup
IPA (PLONK)	~1KB	~10ms	No trusted setup
FRI (STARK)	~50KB	~50ms	Post-quantum safe

JavaScript

// Prove user is over 18 without revealing DOB
const proof = await h33.zkp.prove({
  circuit: 'age_verification',
  privateInputs: {
    dateOfBirth: '1990-05-15'
  },
  publicInputs: {
    minAge: 18,
    currentDate: '2026-01-26'
  },
  scheme: 'groth16'
});

// { proof: "0x...", publicInputs: [...], verified: true }
                            

POST /zkp/verify

Verify a zero-knowledge proof. Returns true if the proof is valid for the given public inputs and verification key.

2 credits

Turbo Cost

~3ms

Verify Time

JavaScript

const isValid = await h33.zkp.verify({
  proof: proofFromUser,
  publicInputs: expectedPublicInputs,
  verificationKey: circuitVK
});

// { valid: true, timestamp: "2026-01-26T..." }
                            

Quantum Signatures

NIST FIPS 203/204 compliant post-quantum digital signatures. Resistant to attacks from both classical and quantum computers.

🔐

Algorithms Supported

CRYSTALS-Dilithium - Primary (FIPS 204)
CRYSTALS-Kyber - Key encapsulation (FIPS 203)
FALCON - Compact signatures

POST /quantum/sign

Sign data using a quantum-resistant algorithm. Default: Dilithium3 (NIST security level 3).

60µs

Sign Time

39µs

Verify Time

3 credits

Turbo Cost

JavaScript

// Generate quantum-resistant key pair
const keys = await h33.quantum.generateKeyPair({
  algorithm: 'dilithium3'
});

// Sign data
const signature = await h33.quantum.sign({
  data: messageToSign,
  privateKey: keys.privateKey,
  algorithm: 'dilithium3'
});

// Verify signature
const valid = await h33.quantum.verify({
  data: messageToSign,
  signature: signature,
  publicKey: keys.publicKey
});
                            

Blockchain Attestation

POST /blockchain/attest

Create an immutable attestation record on Solana. Perfect for audit trails, compliance records, and tamper-proof logging.

1 credit

Cost

~400ms

Confirmation

JavaScript

const attestation = await h33.blockchain.attest({
  data: {
    userId: 'user_123',
    action: 'kyc_verified',
    timestamp: Date.now()
  },
  network: 'solana',
  compress: true  // ZK-compressed (5000x less expensive)
});

// { txHash: "5KtPn...", slot: 123456789, explorer: "https://..." }
                            

POST /blockchain/mint-sbt

Mint a Soulbound Token (non-transferable NFT) representing verified identity credentials. Included with KYC packages.

JavaScript

const sbt = await h33.blockchain.mintSbt({
  userId: 'user_123',
  walletAddress: 'Gh9ZwE...',
  credentials: {
    kycLevel: 'enhanced',
    verifiedAt: '2026-01-26',
    expiresAt: '2027-01-26'
  }
});

// { mint: "H33sbt...", metadata: "https://...", txHash: "..." }
                            

KYC Verification

POST /kyc/verify

Complete KYC verification with FHE-encrypted biometrics, ZK proofs, and blockchain attestation. Includes Soulbound NFT minting.

Pricing

Package	Price	Includes
KYC Basic + SBT	$49	ID + Selfie + Liveness + Soulbound NFT
KYC Enhanced + SBT	$79	Basic + Proof of Address
Full Bundle	$99	Enhanced KYC + AML + Soulbound NFT

JavaScript

const kyc = await h33.kyc.verify({
  userId: 'user_123',
  package: 'full_bundle',  // $99
  documents: {
    idFront: idFrontBase64,
    idBack: idBackBase64,
    selfie: selfieBase64,
    proofOfAddress: pobBase64
  },
  walletAddress: 'Gh9ZwE...'  // For SBT mint
});

// {
//   status: "verified",
//   level: "enhanced",
//   amlClear: true,
//   zkProof: "0x...",
//   sbtMint: "H33sbt..."
// }
                            

Continuous Authentication

WS /auth/continuous PATENT PENDING

Real-time continuous authentication using multi-modal behavioral biometrics. LSTM-based temporal modeling of keystroke, mouse, face, and voice patterns.

99.2%

Attack Detection

94.7%

User Accuracy

4 modalities

Fusion

JavaScript

const session = await h33.auth.continuousSession({
  userId: 'user_123',
  modalities: ['keystroke', 'mouse', 'face'],
  sensitivity: 'high'
});

// Stream behavioral data
session.on('keystroke', (event) => {
  session.send({ type: 'keystroke', ...event });
});

// Receive confidence updates
session.on('confidence', ({ score, anomaly }) => {
  if (score < 0.7) triggerReauth();
});
                            

Invisible Authentication

POST /auth/invisible PATENT PENDING

Zero-transmission authentication. No codes displayed on screen. Authentication keys are hardware-secured and never transmitted over the network.

⚠️

Requires Client SDK

Invisible auth requires the H33 client SDK with secure enclave access (iOS Secure Enclave, Android StrongBox, or TPM).

JavaScript

// Initialize invisible auth (one-time setup)
const registration = await h33.auth.invisibleRegister({
  userId: 'user_123',
  deviceId: deviceFingerprint
});

// Authenticate (no visible codes)
const auth = await h33.auth.invisible({
  userId: 'user_123',
  challenge: serverChallenge
});

// { authenticated: true, zkProof: "0x...", timestamp: ... }
                            

Estate Fraud Detection

POST /fraud/estate/analyze PATENT PENDING

Detect behavioral anomalies indicating potential estate fraud. Analyzes shifts from deceased user baselines and detects beneficiary collusion patterns. Generates court-admissible evidence packages.

JavaScript

const analysis = await h33.fraud.estateAnalyze({
  accountId: 'account_123',
  deceasedUserId: 'user_456',
  suspectedActivity: recentTransactions,
  generateEvidence: true
});

// {
//   fraudProbability: 0.94,
//   behavioralShift: { magnitude: 0.87, indicators: [...] },
//   collusionDetected: true,
//   evidencePackage: { hash: "0x...", courtAdmissible: true }
// }
                            

Error Codes

All API errors return a consistent JSON structure with an error code and message.

                        Error Response
                    

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Account has 12 credits, operation requires 15",
    "details": {
      "available": 12,
      "required": 15
    }
  }
}
                    

Code	HTTP	Description
`INVALID_API_KEY`	401	API key is missing, invalid, or revoked
`INSUFFICIENT_CREDITS`	402	Not enough credits for the operation
`RATE_LIMITED`	429	Too many requests, slow down
`INVALID_BIOMETRIC`	400	Biometric data is malformed or unreadable
`USER_NOT_ENROLLED`	404	No biometric template found for user
`VERIFICATION_FAILED`	200	Biometric match failed (not an error)
`CIRCUIT_NOT_FOUND`	404	ZK circuit ID not found
`PROOF_INVALID`	400	ZK proof verification failed
`BLOCKCHAIN_ERROR`	502	Blockchain network error

Rate Limits

Rate limits vary by tier and are applied per API key.

Tier	Requests/sec	Requests/day	Burst
Trial	10	1,000	20
Starter	50	50,000	100
Growth	100	100,000	200
Business	500	500,000	1,000
Scale+	1,000	Unlimited	2,000

ℹ️

Rate Limit Headers

X-RateLimit-Limit - Maximum requests allowed
X-RateLimit-Remaining - Requests remaining
X-RateLimit-Reset - Unix timestamp when limit resets

SDKs & Libraries

Official client libraries with TypeScript definitions, async/await support, and automatic retries.

                        Installation
                    

# Node.js / TypeScript
npm install @h33/client

# Python
pip install h33

# Go
go get github.com/h33-ai/h33-go

# Rust
cargo add h33

# React Native
npm install @h33/react-native
                    

SDK Features

Full TypeScript definitions
Automatic retry with exponential backoff
Request/response logging
Webhook signature verification
Secure enclave integration (mobile)
Biometric capture helpers

Quick Start

Get started in 3 steps

Authentication

Key Management

Pricing & Credits

Credit Costs by Operation

KYC / Identity (Fixed Pricing)

Full Stack Auth

The flagship endpoint

Request Body

Example Request

Example Response

Biometric Enroll

Request Body

Biometric Verify

FHE Encryption

FHE Modes

FHE Compute

Zero-Knowledge Proofs

Supported Proof Types

Quantum Signatures

Blockchain Attestation

KYC Verification

Pricing

Continuous Authentication

Invisible Authentication

Estate Fraud Detection

Error Codes

Rate Limits

SDKs & Libraries

SDK Features