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.
passport is null here (issued via paid routes only).
Fresh signed Passports 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": null,
    "wallet_chain": null
  },
  "sigil": {
    "identity_class": "autonomous",
    "issued_at": "2026-02-16T12:00:00.000Z",
    "explorer_url": "https://explorer.solana.com/tx/..."
  },
  "passport": null,
  "beat_state": {
    "beat_count": 2200,
    "lifetime_beats": 2200,
    "available_beats": 0,
    "last_checkin_beat": 9600,
    "last_global_sync": 9600,
    "total_heartbeats": 142,
    "difficulty": 1000,
    "status": "active"
  },
  "liveness": {
    "score": 0.95,
    "algorithm": "v1",
    "computed_at": "2026-03-09T12:00:00.000Z",
    "grace_period": false
  },
  "lineage_proof": null,
  "lineage_depth": 1,
  "network": {
    "current_anchor_index": 10423,
    "anchor_degraded": false
  }
}

Key fields

Field	Meaning
`standing`	`registered`, `active`, `warning`, `stale`, `frozen`, or `refused`
`beat_state.lifetime_beats`	Total accepted beats over lifetime
`beat_state.total_heartbeats`	Total heartbeats submitted by this agent
`beat_state.available_beats`	Spendable beat balance used for spawn gating
`liveness`	Liveness score object, or `null` if in grace period (under 7 days) or sandbox
`liveness.score`	Rolling 30-day liveness score (0.0–1.0)
`liveness.algorithm`	Algorithm version (e.g., `"v1"`)
`liveness.computed_at`	ISO timestamp of last score computation
`liveness.grace_period`	`true` if agent is within 7-day grace period
`lineage_proof`	Deprecated alias for `passport` (both returned for backward compatibility)
`lineage_depth`	Agent’s depth in lineage tree (0 = root)
`sigil`	Present only for SIGIL holders
`lineage`	Chain summary from agent to root
`root`	Root identity summary
`network.anchor_degraded`	`true` if Solana anchor pipeline is degraded

Not found


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

GET /api/v1/verify/:hash

Important

Example response

Key fields

Not found

Rate limit: 60/min per IP