Quick Start

Get your first AI-powered verdict in under 5 minutes.

1. Create an Account

Sign up at askverdict.ai/sign-up. You can use email/password, GitHub, or Google OAuth.

Free accounts include 10 credits on signup with all debate modes unlocked.

2. Generate an API Key

Navigate to the Developer Portal → API Keys and click Create Key. Give it a name like "my-first-key".

Copy the key — it starts with vrd_ and is only shown once.

3. Make Your First Request

curl -X POST https://api.askverdict.ai/v1/verdicts \
  -H "Authorization: Bearer vrd_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Should I learn Rust or Go for backend development?",
    "mode": "balanced"
  }'

The response includes the debate ID. The debate runs asynchronously — use the stream endpoint to follow along in real-time.

4. Stream Results

Watch the debate unfold in real-time via Server-Sent Events:

curl -N https://api.askverdict.ai/v1/verdicts/DEBATE_ID/stream \
  -H "Authorization: Bearer vrd_your_api_key"

SSE events include:

• debate.started — Debate has begun
• argument — An agent has made an argument
• rebuttal — An agent has rebutted
• verdict — Final verdict delivered
• debate.completed — Debate is finished

5. Get the Final Verdict

Once the debate completes, fetch the full result:

curl https://api.askverdict.ai/v1/verdicts/DEBATE_ID \
  -H "Authorization: Bearer vrd_your_api_key"

The response includes:

• verdict.recommendation — "Learn Go" or "Learn Rust"
• verdict.oneLiner — Brief summary
• verdict.confidence — 0–100 score
• verdict.arguments — Full Pro/Con breakdown

Next Steps

• Explore the Playground — Test endpoints interactively
• API Reference — Full endpoint docs
• SDK Installation — TypeScript SDK setup
• CLI Guide — Command-line tool