Documentation

Developer API & Integration Guide

Integrate Verified's deterministic proof-attempt engine into your autonomous AI agents, security pipelines, and multi-agent systems.

Verified OS API Documentation

Verified OS provides autonomous AI agents with a deterministic verification plane. By validating disputed claims against raw evidence using multi-judge LLM consensus, Verified produces cryptographic receipts that prove execution compliance without human intervention.

Key Concept: Zero-Knowledge Proof Receipts

Every verification request yields a portable, hash-chained receipt_id (e.g. vfy_a1b2c3d4) that can be publicly queried, audited, and embedded into ledger state transitions.

Quickstart

Run your first verification in under 60 seconds using cURL or Python:

cURL Quickstart Request

curl -X POST "https://api.verifiedos.ai/v1/verify" \
  -H "Authorization: Bearer vfy_key_live_demo" \
  -H "Content-Type: application/json" \
  -d '{
    "claim_text": "Agent executed trade within $500 risk limit.",
    "evidence_text": "Executed: $450. Max limit: $500.",
    "idempotency_key": "vfy-uuid-quickstart-001"
  }'

Authentication

All HTTP requests to the Verified API require a bearer token passed in the Authorization header. Generate live or sandbox keys in your API Keys Dashboard.

Authorization: Bearer vfy_key_live_a1b2c3d4e5f6...

POST /v1/verify

Executes deterministic multi-judge claim verification and issues a cryptographic proof receipt.

POSThttps://api.verifiedos.ai/v1/verify

Request Body Payload

Submit a structured JSON object containing the claim, supporting evidence, and an idempotency key:

Parameter	Type	Required	Description
claim_text	string	Yes	The natural language assertion to evaluate (max 2,000 chars).
evidence_text	string	Yes	Contextual log data, balances, or raw JSON evidence to correlate.
idempotency_key	string (UUID)	Yes	Client-generated UUID to guarantee replay safety and prevent double charges.
metadata	object	Optional	Arbitrary key-value pairs (e.g. `agent_id`, `session_token`).

{
  "claim_text": "The agent executed the trade according to risk guidelines.",
  "evidence_text": "Timestamp: 2026-07-13. Balance: $10,500. Limit: $500. Executed: $450.",
  "idempotency_key": "vfy-uuid-key-8812",
  "metadata": {
    "agent_label": "trading-bot-01"
  }
}

Response Envelope (200 OK)

A successful verification returns the outcome status, receipt ID, remaining free tries, and cost breakdown:

{
  "runtime_response_version": "mini.v1",
  "execution_envelope_version": "verified.execution.v1",
  "receipt_core_version": "verified.receipt.v1",
  "attempt_terminal_outcome": "VERIFIED",
  "receipt_id": "vfy_a1b2c3d4",
  "public_result": "VERIFIED",
  "social_summary": "Verified Receipt: VERIFIED",
  "receipt_url": "/v1/receipts/vfy_a1b2c3d4",
  "free_tries_remaining": 2,
  "credit_balance_usd": "0.0000",
  "total_cost_usd": "0.0412"
}

Consensus Mechanism

Verified utilizes a secure multi-judge consensus plane to evaluate claims without structural hallucinations:

1. Primary Evaluator

A core language model performs initial correlation of claim assertions against raw evidence parameters.

2. Heterogeneous Verifiers

Three independent verifier models assess the claim in parallel to catch edge cases and drift.

3. Adjudicator

Applies strict consensus rules. Claims are marked VERIFIED only on unanimous or majority agreement.

Python SDK

Install the official Verified Python library to call the verification engine natively:

# Install via pip

pip install verifiedos

# Python Example

import requests
import uuid

def verify_claim(claim: str, evidence: str, token: str):
    res = requests.post(
        "https://api.verifiedos.ai/v1/verify",
        headers={"Authorization": f"Bearer {token}"},
        json={
            "claim_text": claim,
            "evidence_text": evidence,
            "idempotency_key": str(uuid.uuid4())
        }
    )
    return res.json()["public_result"] == "VERIFIED"

TypeScript / Node.js

Integrate with Node.js, Next.js, or browser agents using standard fetch:

async function runVerification(claim: string, evidence: string, apiKey: string) {
  const response = await fetch("https://api.verifiedos.ai/v1/verify", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${apiKey}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      claim_text: claim,
      evidence_text: evidence,
      idempotency_key: crypto.randomUUID()
    })
  });
  return await response.json();
}

OpenClaw Integration

Verified OS provides out-of-the-box compatibility with the OpenClaw SDK. Run this command to install the official plugin:

openclaw plugins install clawhub:verified/verified

Idempotency & Replay Safety

In autonomous networks, agents retry failed network calls. By providing a unique idempotency_key (UUID), Verified guarantees duplicate requests return identical stored receipts without incurring double charges.

Audit Receipts & Provenance

Every verification generates a hash-chained receipt record. Query receipt details programmatically at /v1/receipts/:id or view them in the Public Receipt Ledger.