Skip to main content

​
GET /v1/verify

Verify hash chain integrity for an agent.

​
Query parameters

ParameterTypeDescription
agent_idstringRequired. Agent ID to verify

​
Example

curl "http://localhost:7600/v1/verify?agent_id=my-agent"

​
Response (valid)

{
  "valid": true,
  "agent_id": "my-agent",
  "events_verified": 150
}

​
Response (invalid)

{
  "valid": false,
  "agent_id": "my-agent",
  "error": "hash mismatch at sequence 42"
}

​
GET /v1/merkle/root

Compute the Merkle root across all chains.

​
Example

curl http://localhost:7600/v1/merkle/root

​
Response

{
  "root": "a1b2c3d4e5f6...",
  "tree_size": 1500
}
The root is computed on demand and represents the current integrity state of all stored events.

​
GET /v1/export

Export a verifiable evidence package.

​
Query parameters

ParameterTypeDescription
agent_idstringRequired. Agent ID to export
sincestringStart time (ISO 8601)
untilstringEnd time (ISO 8601)

​
Example

curl "http://localhost:7600/v1/export?agent_id=my-agent" > package.plog

​
Response

Returns a .plog JSON document containing events, hash chain data, and Merkle inclusion proofs. See Verifiable Exports for the full format.