Verification

The core of AIP-1. Before your agent performs any action, call /api/verify to run the 8-step verification pipeline. The protocol checks identity, boundaries, revocation status, and computes a trust score — all in milliseconds.

Verification Pipeline (8 steps)

1
Agent Lookup— Find agent in registry
2
Revocation Check— Not revoked or suspended
3
Signature Verification— Ed25519 signature valid
4
Action Boundary— Action is in allow-list
5
Monetary Limit— Amount within limits
6
Geo Restriction— Region is permitted
7
Delegation Chain— Authority chain valid
8
Trust Score— Bayesian reputation check
POST/api/verifyAPI Key

Verify an agent's intent through the full 8-step pipeline. This is the primary endpoint for programmatic use.

Request Body

agent_idstring*
The agent's DID (e.g. "did:web:yourco.com:agents:my-bot")
actionstring*
Action the agent wants to perform (e.g. "transfer_funds")
targetstring
Target DID or identifier of the receiving party
parametersobject
Action-specific params. Include "amount" for monetary actions.
python
import requests

result = requests.post("https://aip.synthexai.tech/api/verify",
    headers={"X-API-Key": "kya_your_key"},
    json={
        "agent_id": "did:web:yourco.com:agents:procurement-bot",
        "action": "transfer_funds",
        "target": "did:web:vendor.com",
        "parameters": {"amount": 45.00}
    }
).json()

# ✓ Successful verification:
# {
#   "verified": true,
#   "tier": "tier_1",
#   "signature_valid": true,
#   "within_boundaries": true,
#   "attestation_match": true,
#   "revoked": false,
#   "trust_score": 0.847,
#   "latency_ms": 3.21,
#   "errors": [],
#   "detail": "All checks passed"
# }

# ✗ Failed verification:
# {
#   "verified": false,
#   "tier": "tier_1",
#   "within_boundaries": false,
#   "trust_score": 0.42,
#   "errors": [
#     {"code": "AIP-E200", "name": "ACTION_NOT_ALLOWED"}
#   ],
#   "detail": "Action 'delete_all' not in allowed_actions"
# }