Quickstart

Get a multi-agent consensus verdict in 3 steps.

1. Get an API Key

# Free — no credit card required
curl -X POST https://verdikt.campintl.io/api/keys \
  -H "Content-Type: application/json" \
  -d '{"owner": "your@email.com"}'

2. Submit a Verdict

curl -X POST https://verdikt.campintl.io/api/verdict \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "domain": "hiring",
    "question": "Should we hire a senior engineer who has 8 years experience but changes jobs every 12 months?",
    "context": "50-person startup, need frontend lead, strong portfolio",
    "agentCount": 5
  }'

3. Get the Verdict

{
  "success": true,
  "verdict": {
    "id": "VDK-MMMKGG6C-CB970138",
    "verdict": "MAYBE",
    "strength": "MODERATE",
    "confidence": 60,
    "percentages": { "YES": 0, "NO": 47, "MAYBE": 53 },
    "agents": [
      { "name": "Culture Fit Analyst", "action": "NO", "confidence": 80, "reasoning": "..." },
      { "name": "Technical Evaluator", "action": "NO", "confidence": 80, "reasoning": "..." },
      // ... more agents
    ],
    "dissent": [ /* agents who voted against the consensus */ ],
    "meta": { "elapsedMs": 559, "engine": "VERDIKT v1.0" }
  }
}

Authentication

All API requests require an API key in the X-API-Key header.

X-API-Key: vdk_free_abc123...

Keys are prefixed by tier: vdk_free_, vdk_pro_, vdk_ent_.

Tiers & Limits

Error Handling

Errors return JSON with an error field:

{
  "error": "Daily limit reached (10 verdicts). Upgrade tier for more."
}

Submit Verdict

List Verdicts

Get Verdict Detail

List Agents

Create Custom Domain

curl -X POST /api/domains \
  -H "X-API-Key: YOUR_PRO_KEY" \
  -d '{
    "name": "Startup Pitch",
    "actions": ["INVEST", "PASS", "FOLLOW_UP"],
    "agents": [
      {"id": "market", "name": "Market Analyst", "prompt": "Evaluate TAM/SAM/SOM...", "weight": 1.3},
      {"id": "team", "name": "Team Evaluator", "prompt": "Assess founding team...", "weight": 1.5}
    ]
  }'

List Custom Domains

Update Custom Domain

Delete Custom Domain

Report Outcome

Agent Leaderboard

Register Webhook

List Webhooks

Webhook Signature Verification

Every webhook delivery includes an X-Verdikt-Signature header containing the HMAC-SHA256 signature of the raw request body.

Node.js

const crypto = require('crypto');

function verifyWebhook(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Python

import hmac, hashlib

def verify_webhook(raw_body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(), raw_body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)

Webhook Payload Shape

{
  "event": "verdict.completed",
  "timestamp": "2026-03-11T21:43:57.715Z",
  "data": {
    "id": "VDK-MMMKGG6C-CB970138",
    "domain": "hiring",
    "verdict": "MAYBE",
    "strength": "MODERATE",
    "confidence": 60,
    "agentCount": 5,
    "question": "Should we hire..."
  }
}

Provision API Key

Usage Analytics

Upgrade Tier