Skip to main content

Evidence API

The Evidence API provides cryptographic proofs of delivery for every webhook event processed by Zen Mesh. Each delivery produces a Merkle-tree inclusion proof that can be independently verified.

Read Delivery Evidence​

curl -H "Authorization: Bearer $ZEN_API_KEY" \
  -H "X-Tenant-ID: $ZEN_TENANT_ID" \
  https://api.zen-mesh.io/v1/evidence/<delivery-id>

Response:

{
  "delivery_id": "dlv_abc123",
  "merkle_root": "a1b2c3d4e5f67890...",
  "inclusion_proof": [
    "x1y2z3...",
    "p4q5r6..."
  ],
  "leaf_hash": "abcdef...",
  "timestamp": "2026-06-01T12:00:03Z",
  "status": "confirmed"
}

List Evidence for a Source​

curl -H "Authorization: Bearer $ZEN_API_KEY" \
  -H "X-Tenant-ID: $ZEN_TENANT_ID" \
  https://api.zen-mesh.io/v1/sources/<source-id>/evidence?limit=10

Verify a Merkle Inclusion Proof​

Clients can verify delivery integrity without trusting the platform:

  1. Retrieve the evidence proof for the delivery
  2. Compute SHA-256(delivery_payload + timestamp + tenant_id)
  3. Combine with the inclusion_proof hashes per the Merkle tree algorithm
  4. Compare the resulting root with merkle_root

If the computed root matches the published root, the delivery is cryptographically confirmed.

Pagination​

Evidence lists support cursor-based pagination with limit and cursor parameters.