/v1/humanHuman verification for AI agents — proof of humanity, sybil resistance, and 'is this wallet a real person' answers in one paid call. Returns two ZK-style outputs about any EVM wallet: (1) total humanity score 0-255 (15 = baseline reCAPTCHA, 45 = + Google OAuth, 70 = + Apple ID, 105 = + 2FA, 255 = full stack), with optional `min_score=N` for a yes/no `passes` verdict; (2) per-method verification check via `check=telegram,apple,g2fa,...` — buyer must NAME the methods to ask about, we never enumerate the full set. Backed by 141,871 Twin Matrix Soulbound Tokens on BNB Chain plus the canonical humanity registry off-chain. The underlying verification list never leaves Twin3 — only verdicts.
{
"properties": {
"check": {
"description": "Optional CSV of specific verification methods to check (minimal-disclosure: buyer must name them; we don't enumerate). Returns `verifications: {method: bool}` for ONLY the methods asked. Valid methods: recaptcha, google, discord, line, telegram, apple, g2fa, onchain, worldid.",
"type": "string"
},
"include": {
"description": "Optional CSV of richer fields: `verified_at` (SBT mint timestamp, useful for sybil-pattern detection), `dimensions_filled` (count of non-zero matrix bytes, profile completeness signal).",
"type": "string"
},
"match": {
"description": "Optional CSV of attribute match conditions `key:value` (AND-ed). Returns pass/fail per condition + overall `matched` — NEVER the raw values (minimal disclosure). Keys: age, gender, occupation, income, social, web3, ai, risk, interest. A `+` suffix on ordered keys (age/income/web3/ai/risk) means '≥ this level'. Examples: `age:25-34`, `income:200-500+`, `social:instagram`, `interest:travel`.",
"type": "string"
},
"min_score": {
"description": "Optional integer 0-255. When set, response adds `passes: bool` indicating whether the wallet's humanity score meets the threshold. Reference levels: 15 = baseline (reCAPTCHA + sybil filter), 45 = + Google OAuth, 70 = + Apple ID, 105 = + 2FA, 255 = full verification stack.",
"pattern": "^([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$",
"type": "string"
},
"wallet": {
"description": "EVM address (0x-prefixed, 40 hex chars). The wallet to verify.",
"pattern": "^0x[a-fA-F0-9]{40}$",
"type": "string"
}
},
"required": [
"wallet"
],
"type": "object"
}{
"confidence": "high",
"dimensionsFilled": 8,
"isHuman": true,
"lastVerifiedAt": "2026-03-02T09:41:00Z",
"match": {
"conditions": [
{
"key": "age",
"pass": true,
"value": "25-34"
},
{
"key": "interest",
"pass": true,
"value": "travel"
}
],
"matched": true
},
"methodsCount": 4,
"passes": true,
"queriedAt": "2026-05-10T12:00:00Z",
"sbtId": 142031,
"score": 105,
"scoreCeiling": 255,
"scoreFloor": 15,
"scoreSource": "firestore",
"tier": "high",
"verifications": {
"apple": false,
"telegram": true
},
"verifiedAt": "2025-09-12T03:14:22Z",
"wallet": "0x1234567890123456789012345678901234567890"
}