API Reference

The RealAIID API allows institutions and developers to query the Philadelphia Mainframe to verify human likeness and enforce rights under the NO FAKES Act.

Authentication

All requests must include your Sovereign-tier API Key in the header.

Authorization: Bearer REAL_AIID_LIAISON_KEY_XXXXX

GET /v1/verify/vssn/{hash}

Retrieves the verification status of a specific VSSN hash anchored at 1900 Market.

Parameter	Type	Description
hash	string	The unique VSSN hash to be verified.
anchor_node	string	(Optional) Specify PHL-MAIN-01 or airport nodes.

{
  "status": "VERIFIED_HUMAN",
  "anchor_date": "2026-03-27T18:08:42Z",
  "origin": "1900_MARKET_PHL_USA",
  "confidence_score": 0.9998
}
                

POST /v1/enforce/likeness-check

Submit a media URL to compare against the Registered Likeness Shield database.

curl -X POST https://api.realaiid.com/v1/enforce/likeness-check \
  -H "Content-Type: application/json" \
  -d '{
    "media_url": "https://media.source/video_sample.mp4",
    "vssn_target": "PHL-8821-X99"
  }'
                