VSSN Integration Guide

The RealAIID API allows institutional partners to programmatically verify human core presence and anchor vocal signatures to the Philadelphia Mainframe.

HOST: https://api.realaiid.com/mainframe

Initiate Hashing

To create a unique VSSN hash for a subject, send a POST request containing the biometric vocal packet. All processing occurs within the hardware-encrypted node; no raw audio is stored.

POST /v1/vssn/hash HTTP/1.1
Authorization: Bearer YOUR_SOVEREIGN_KEY
Content-Type: application/json

{
  "node_id": "PHL_1900_MARKET",
  "vocal_sample_id": "VX-7721-B",
  "verification_tier": "SOVEREIGN",
  "statutory_shield": true
}

Response Schema

Parameter	Type	Description
vssn_hash	String	The unique cryptographic ID anchored to the user.
status	Enum	VERIFIED \| PENDING \| REJECTED
latency_ms	Integer	Mainframe response time (Target: <150ms).