BRIDGE API Reference

One endpoint, one bearer token, signed consensus out. SDKs in five languages, MCP-compatible, GitHub Action, OpenAI / Copilot / Gemini plugins. This page is the authoritative reference.

BASE URL https://api.getbridge.dev/v1

Introduction

The BRIDGE API exposes the verification protocol: dispatch content to a panel of frontier AI models, orchestrate adversarial debate when they disagree, return a signed consensus with confidence score and audit trail.

Every endpoint returns JSON. Every response includes consensus_id when applicable. Every consensus is reproducible — the same input dispatched within 24 hours returns the cached result with the same consensus_id.

Authentication

All requests require a bearer token in the Authorization header. Create keys at Dashboard → API Keys.

$ curl https://api.getbridge.dev/v1/auth/me \
   -H "Authorization: Bearer sk_live_..."

Keys are scoped: read, verify, ask, admin. Production keys are prefixed sk_live_; test keys sk_test_. Rotate keys via dashboard or API.

Base URL & Versions

Production: https://api.getbridge.dev/v1. Sandbox: https://api.getbridge.dev/v1?env=sandbox (free, returns cached canned responses). EU residency: https://api.eu.getbridge.dev/v1.

The v1 version is stable. Breaking changes will go to v2 with 12-month deprecation notice for v1.

Error Codes

CODE	HTTP	MEANING
`BRIDGE_UNAUTHENTICATED`	401	Missing or invalid token.
`BRIDGE_FORBIDDEN`	403	Token lacks scope.
`BRIDGE_QUOTA_EXCEEDED`	402	Plan quota hit.
`BRIDGE_RATE_LIMITED`	429	Rate limit hit. Retry-After provided.
`BRIDGE_LOOP_DETECTED`	429	Recursive verify of a prior result.
`BRIDGE_INPUT_TOO_LARGE`	413	Content exceeds tier limit.
`BRIDGE_PANEL_UNAVAILABLE`	503	≥ 2 models in panel timed out.

POST /v1/verify CORE · TIER 1–3

Run the full consensus protocol on a content artifact. Returns verdict, confidence, corrections, audit hash.

Request body

PARAM	TYPE	DESCRIPTION
`content`	string required	Up to 50K tokens.
`tier`	1 \| 2 \| 3	Routing tier. Default `2`.
`category`	string	contracts · code · claims · business · healthcare · compliance · other
`panel`	string[]	Override model selection. Team / Enterprise only.
`threshold`	number	Confidence threshold for findings. 0.50–0.99. Default 0.75.
`project_id`	string	Attribute to a project.

Response (200 OK)

{
  "consensus_id": "c_7f2a91b4e8c3d09f",
  "verdict": "verified_with_corrections",
  "confidence": 0.942,
  "models_agreed": 5,
  "rounds": 2,
  "latency_ms": 4823,
  "corrected_content": "...",
  "corrections": [
    { "id": "F-01", "severity": "high", "applied": true }
  ],
  "audit": {
    "input_hash": "0xa8f3...",
    "signature": "ed25519:3a91...",
    "chain_block": 2184309
  }
}

POST /v1/ask ASK · CONVERSATIONAL

Verified Answers — conversational endpoint. Routes automatically across tiers. Returns body + confidence + optionally debate transcript.

Request body

PARAM	TYPE	DESCRIPTION
`query`	string required	The question.
`conversation_id`	string	Continue a prior conversation.
`force_tier`	"auto" \| 1 \| 2 \| 3	Override automatic routing.
`include_transcript`	boolean	Include the debate transcript for T3 responses. Default `false`.

GET /v1/consensus/records AUDIT

List consensus records for your account. Paginated, filterable.

Query parameters

PARAM	TYPE	DESCRIPTION
`limit`	int	1–100. Default 25.
`cursor`	string	Pagination cursor.
`category`	string	Filter by category.
`min_confidence`	number	Filter by min confidence.
`from` / `to`	ISO 8601	Date range.

GET /v1/consensus/{id} AUDIT

Retrieve a single consensus by ID. Includes full panel verdicts, corrections, signed audit hash, and chain anchor.

GET /v1/consensus/{id}/report AUDIT · PDF

Generate a signed PDF audit report. Includes methodology, per-model verdicts, debate transcript, and chain proof. Returns application/pdf.

GET /v1/models PUBLIC

List available panel models with current health, latency, and pricing. No auth required.

GET /v1/leaderboard PUBLIC · CACHED 5MIN

Live model performance rankings. No auth. Returns 7-day adversarial survival scores by domain.

GET /v1/auth/me ACCOUNT

Returns your account info: user ID, tier, organization, scopes, current usage.

GET /v1/billing/status ACCOUNT

Current plan, usage against quota, next invoice date.

POST /v1/projects ACCOUNT

Create a project. Also GET, PUT, DELETE on /v1/projects/{id}.

POST /v1/api-keys ACCOUNT

Create a new API key. Returns the full key once (the only time you'll see it). Subsequent listings show prefix only.

POST /v1/webhooks AUTOMATION

Create a webhook subscription. Events: consensus.completed, consensus.failed, usage.threshold. Payloads HMAC-SHA256 signed; verify with the X-BRIDGE-Signature header.

Guide · Tier Routing

BRIDGE routes queries across three tiers automatically. You can override with tier on verify or force_tier on ask.

Tier 1. Single-pass, 3-model panel. ~0.8s avg. For factual lookups where models agree on first attempt.
Tier 2. 5-model panel, single round. ~2–4s. Default for substantive queries.
Tier 3. 5-model panel, adversarial debate until consensus. 3–8s. For contested questions.

Guide · Webhook Signatures

Every webhook payload is signed with HMAC-SHA256 of the request body, keyed with your webhook secret. Verify before acting.

$ echo -n "$BODY" | openssl dgst -sha256 -hmac "$SECRET"
# Compare with X-BRIDGE-Signature header (constant-time compare)

Guide · Rate Limits

TIER	REQ / MIN	BURST
Starter	60	120
Builder	600	1,200
Team	6,000	12,000
Enterprise	Custom	Custom

Guide · SDKs

Five official SDKs: Python, JavaScript / TypeScript, Go, Ruby. Beta: Rust, Java. See Developers.