← Back to Pronnpt

Decision Engine API

Get a decision, not an answer.

Resolve uncertainty via structured multi-model disagreement. 5 frontier AIs debate your question and return a verdict with confidence score, ranked recommendations, and cost transparency.

Get API KeyQuick Start

Quick Start

One POST request. Structured JSON response. That's it.

bash
curl -X POST https://api.pronnpt.com/v1/debate/run \
  -H "Authorization: Bearer prn_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Should my startup pivot to AI?",
    "speed": "fast"
  }'

Base URL

text
https://api.pronnpt.com/v1

All API endpoints are versioned under /v1.

Endpoints

POST/v1/debate/run

Run a new debate. Returns structured verdict (proposition) or ranked recommendations (strategy).

GET/api/debate?id=123

Fetch a completed debate with full report, phases, and follow-up questions.

GET/api/debates?page=1&limit=10&category=Technology

Browse public debates. Filter by category. Paginated.

Parameters

POST body for /v1/debate/run

ParameterTypeDefaultDescription
questionstringrequiredThe question to debate (min 10 characters)
type"proposition" | "strategy"autoDebate type. Auto-classified if omitted
modelsstring[]all 5Which models: ["claude","gpt","grok"]
model_countnumberShorthand: use first N models (1–5)
speed"fast" | "medium" | "full""full"Controls depth, speed, and cost
chair_modelstringfirst modelWhich model chairs the final synthesis
max_cost_usdnumberPre-flight cost gate. Returns 400 if estimate exceeds
max_latency_msnumberLatency budget. Auto-selects speed if set
response_mode"full" | "summary""full"Summary returns just decision + confidence
streambooleanfalseEnable SSE streaming for real-time progress

Speed Modes

Set speed directly, or set max_latency_ms and we'll pick the fastest mode that fits your budget.

Fast
Quick verdict with quorum. Best for high-volume pipelines and rapid decisions.
< 10s$0.01–0.054 LLM calls3 models
Medium
Balanced depth and speed. Each model analyses independently + final synthesis.
~ 30s$0.05–0.106 LLM callsAll selected
Full
Full 3-round deliberation with cross-examination and structured disagreement.
2–5 min$0.15–0.3013 LLM callsAll selected

Available Models

OpenRouter prices per 1M tokens. We charge exactly what OpenRouter charges us — zero markup.

API IDModelInput /1MOutput /1M
claudeOpus 4.6$15$75
gptGPT-5.4$2.50$10
grokGrok 4.1 Fast$5$25
geminiGemini 2.5 Flash$0.15$3.50
deepseekDeepSeek V3.2$0.27$1.10

Use Cases

Trading decisions, product strategy, legal reasoning, clinical judgement, research synthesis, policy analysis.

Legal
Stress-test legal positions across multiple reasoning styles before advising clients.
Is this contract clause enforceable under UK law?
Medical
Get multi-perspective clinical reasoning for complex treatment decisions.
Should I recommend statins for a patient with borderline cholesterol?
Engineering
Evaluate technical trade-offs with structured disagreement before committing.
Should we migrate from MongoDB to PostgreSQL?
Finance
Run multi-model analysis on market positions and get a confidence-weighted verdict.
Will NVDA beat earnings this quarter?
Journalism
Fact-check and stress-test stories before publication with adversarial review.
Is this claim supported by primary sources?
Strategy
Get ranked strategic recommendations from models with different thinking styles.
Should we enter the European market in 2026?
Research
Compare methodological approaches with structured expert-style deliberation.
What methodology best fits this study design?
Accounting
Evaluate structural options with multi-angle analysis of regulatory implications.
What's the optimal corporate structure for tax efficiency?
Policy
Identify blind spots and steelman opposing positions before going public.
What's the strongest counter-argument to this policy?

Code Examples

bash
curl -X POST https://api.pronnpt.com/v1/debate/run \
  -H "Authorization: Bearer prn_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Should my startup pivot to AI?",
    "speed": "fast"
  }'

Summary Mode

Set response_mode: "summary" to get just the decision, confidence, and cost. Perfect for agents that only need the verdict.

javascript
// Minimal response — just the decision
const res = await fetch("https://api.pronnpt.com/v1/debate/run", {
  method: "POST",
  headers: {
    "Authorization": "Bearer prn_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    question: "Should we acquire this company?",
    speed: "fast",
    response_mode: "summary"
  })
});

// Returns:
// {
//   "debate_id": 305,
//   "type": "proposition",
//   "decision": "REJECT",
//   "confidence": 0.60,
//   "executive_summary": "The council advises...",
//   "cost_usd": 0.02,
//   "tokens_used": 3100
// }

Response Format

Proposition debates return a verdict with decision (ACCEPT/REJECT/SPLIT) and numeric confidence. Strategy debates return a synthesis with ranked recommendations.

Proposition Response
json
{
  "debate_id": 301,
  "type": "proposition",
  "status": "complete",
  "models": ["claude", "gpt", "grok"],
  "speed": "fast",
  "verdict": {
    "decision": "ACCEPT",
    "confidence": 0.85,
    "vote_split": { "for": 2, "against": 1 },
    "executive_summary": "The council recommends..."
  },
  "chair_summary": {
    "recommendation": "...",
    "consensus": "...",
    "dissent": "..."
  },
  "follow_up_questions": ["What about...", "Have you considered..."],
  "tokens_used": 4200,
  "cost_usd": 0.03,
  "report_url": "https://pronnpt.com/debate/301"
}
Strategy Response
json
{
  "debate_id": 302,
  "type": "strategy",
  "status": "complete",
  "synthesis": {
    "executive_summary": "The council recommends...",
    "ranked_recommendations": [
      {
        "rank": 1,
        "title": "Use PostgreSQL with TimescaleDB",
        "description": "Combine PostgreSQL reliability with...",
        "proposed_by": "Claude",
        "total_score": 5,
        "avg_rank": 1.25
      }
    ],
    "confidence": 0.85
  },
  "tokens_used": 5100,
  "cost_usd": 0.04,
  "report_url": "https://pronnpt.com/debate/302"
}

Pricing

You pay exactly what OpenRouter charges us for tokens. Zero markup. We may introduce a small margin in the future, but today it's pure pass-through.

Fast (3 models, quick)$0.01 – $0.05
Medium (5 models, quick)$0.05 – $0.10
Full (5 models, 3 rounds)$0.15 – $0.30
Actual cost returned in every response as cost_usd. Use max_cost_usd to cap spending per request. Every debate gets a permanent report page.

API Keys

Sign in to create API keys. Starter tier: 100 requests/day. Scales on request.

Authentication

Pass your API key in the Authorization header:

http
Authorization: Bearer prn_your_key_here

Without a key: 50 free requests per IP. With a key: starter tier at 100/day, scales on request.

Rate Limits

Free tier: 50 requests per IP (no key needed)
Starter: 100 requests/day per key. Scales on request.
Need higher throughput? ben@pronnpt.com

Questions? ben@pronnpt.com