GET /api/v1/verify/:hash

Public read-only verification of agent identity, standing, beat state, SIGIL metadata, and lineage chain summary.

Auth: None


curl https://provenonce.io/api/v1/verify/0x<agent_hash>

Important

This endpoint is read-only.
lineage_proof is null here.
Fresh signed lineage proofs are issued via paid routes (/api/v1/sigil, /api/v1/agent/heartbeat, /api/v1/agent/reissue-proof).

Example response


{
  "verified": true,
  "standing": "active",
  "agent": {
    "hash": "0x...",
    "type": "agent",
    "depth": 1,
    "name": "example-agent",
    "wallet": null,
    "wallet_model": "self-custody",
    "wallet_chain": null
  },
  "sigil": {
    "identity_class": "autonomous",
    "issued_at": "2026-02-16T12:00:00.000Z",
    "explorer_url": "https://explorer.solana.com/tx/..."
  },
  "lineage_proof": null,
  "beat_state": {
    "beat_count": 2200,
    "lifetime_beats": 2200,
    "available_beats": 0,
    "last_checkin_beat": 9600,
    "last_global_sync": 9600,
    "difficulty": 1000,
    "status": "active"
  },
  "network": {
    "current_anchor_index": 10423
  }
}

Key fields

Field	Meaning
`standing`	`registered`, `active`, `warning`, `stale`, `frozen`, or `refused`
`beat_state.lifetime_beats`	Total accepted beats over lifetime
`beat_state.available_beats`	Spendable beat balance used for spawn gating
`sigil`	Present only for SIGIL holders
`lineage`	Chain summary from agent to root
`root`	Root identity summary

Not found


{ "verified": false, "hash": "0x...", "error": "Agent hash not found" }