Evidence API

Every governance evaluation generates a tamper-proof evidence artifact. The Evidence API lets you retrieve, search, verify, and export these artifacts for compliance and audit purposes.

Get Latest Evidence

Retrieve the most recent evidence artifacts by type.

GET /api/v1/evidence/latest

Query Parameters

Parameter	Type	Description
types	string[]	List of artifact types to retrieve (e.g., governance_eval, action_executed)

Example

curl -s "https://api.arqera.io/api/v1/evidence/latest?types=governance_eval&types=action_executed" \
  -H "X-API-Key: $ARQERA_API_KEY"

Response

{
  "items": {
    "governance_eval": {
      "verdict": "proceed",
      "action": "email.send",
      "evaluations": [...],
      "timestamp": "2026-02-22T10:30:00Z"
    },
    "action_executed": {
      "action": "email.send",
      "status": "completed",
      "timestamp": "2026-02-22T10:30:01Z"
    }
  }
}

---

Verify Evidence Chain

Verify the cryptographic integrity of the evidence hash chain. This confirms that no evidence artifacts have been tampered with.

GET /api/v1/evidence/verify

Example

curl -s "https://api.arqera.io/api/v1/evidence/verify" \
  -H "X-API-Key: $ARQERA_API_KEY"

Response

{
  "valid": true,
  "total_artifacts": 1247,
  "verified_count": 1247,
  "chain_head_hash": "sha256:a3f7b2c1d4e5f6a7b8c9d0e1f2a3b4c5",
  "verified_at": "2026-02-22T10:35:00Z"
}

Field	Type	Description
valid	boolean	Whether the entire chain is intact
total_artifacts	number	Total artifacts in the chain
verified_count	number	Number of artifacts verified
chain_head_hash	string	SHA-256 hash of the latest artifact
verified_at	string	ISO 8601 timestamp of verification

---

Search Evidence

Search evidence artifacts by type, date range, action, or verdict.

POST /api/v1/evidence/search

Request Body

{
  "artifact_type": "governance_eval",
  "action": "data.delete",
  "verdict": "block",
  "from_date": "2026-01-01T00:00:00Z",
  "to_date": "2026-02-22T23:59:59Z",
  "limit": 50,
  "offset": 0
}

Field	Type	Required	Description
artifact_type	string	No	Filter by artifact type
action	string	No	Filter by action name
verdict	string	No	Filter by verdict (proceed, escalate, block)
from_date	string	No	Start of date range (ISO 8601)
to_date	string	No	End of date range (ISO 8601)
limit	number	No	Max results (default: 50, max: 100)
offset	number	No	Pagination offset

Response

{
  "items": [
    {
      "id": "ev_a1b2c3d4",
      "artifact_type": "governance_eval",
      "action": "data.delete",
      "verdict": "block",
      "payload": {...},
      "hash": "sha256:...",
      "previous_hash": "sha256:...",
      "created_at": "2026-02-20T14:30:00Z"
    }
  ],
  "total": 23,
  "limit": 50,
  "offset": 0
}

---

Export Evidence

Export evidence artifacts in structured formats for compliance audits.

POST /api/v1/evidence/export

Request Body

{
  "format": "json",
  "from_date": "2026-01-01T00:00:00Z",
  "to_date": "2026-02-22T23:59:59Z",
  "artifact_types": ["governance_eval"],
  "include_chain_verification": true
}

Field	Type	Required	Description
format	string	Yes	"json", "csv", or "pdf"
from_date	string	No	Start of export range
to_date	string	No	End of export range
artifact_types	string[]	No	Filter by artifact types
include_chain_verification	boolean	No	Include hash chain verification in export

Response

{
  "export_id": "exp_x1y2z3",
  "format": "json",
  "artifact_count": 1247,
  "download_url": "https://api.arqera.io/api/v1/evidence/export/exp_x1y2z3/download",
  "expires_at": "2026-02-23T10:35:00Z",
  "chain_verification": {
    "valid": true,
    "total_verified": 1247
  }
}

---

Truth Verification

Run a comprehensive truth verification across all evidence registries. Checks cross-registry consistency and detects knowledge gaps.

GET /api/v1/evidence/truth-verification

Response

{
  "overall_valid": true,
  "registries_checked": 3,
  "consistency_score": 0.99,
  "gaps_detected": 0,
  "verified_at": "2026-02-22T10:40:00Z"
}

---

Evidence Artifact Types

Type	Generated By	Description
governance_eval	Governance Evaluate endpoint	Full governance evaluation result
action_executed	Ara Execute endpoint	Record of an executed action
action_approved	Ara Approve endpoint	Human approval of an escalated action
action_rejected	Ara Reject endpoint	Human rejection of an escalated action
compliance_check	Compliance API	Compliance framework check result
trust_update	Trust scoring system	Change to an actor's trust score

Evidence Storage Limits

Tier	Storage	Retention
Free	1 GB	30 days
Team	10 GB	365 days
Business	100 GB	3 years
Enterprise	Unlimited	Unlimited