# ECCA-AI public API API

**Canonical:** https://apis.io/apis/eccaai-com/ecca-ai-public-api-api/  
**Provider:** ECCA — https://apis.io/providers/eccaai-com/  
**Base URL:** https://eccaai.com  
**Documentation:** https://eccaai.com/developers

ECCA-AI public API API is one of 2 APIs that [ECCA](https://apis.io/providers/eccaai-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

ECCA-AI runs a question through several independent AI engines, then adjudicates their answers into one result and shows the reasoning that settled it. This document is derived from the route handlers under api/ and is pinned by ecca_openapi_contract_test.js: every path maps to a handler file, and e

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/ecca-router` | Engine registry, or the caller's own free-quota usage |
| POST | `/api/ecca-router` | Solve: dispatch a question and receive the adjudicated answer |
| GET | `/api/mcp` | MCP server info and tool list |
| POST | `/api/mcp` | JSON-RPC 2.0: initialize, ping, tools/list, tools/call |
| GET | `/api/v1/axiom/synthesize` | Axiom REST model list |
| POST | `/api/v1/axiom/synthesize` | Chat-completions-shaped synthesis over the same engine registry |
| POST | `/api/ecca-transcribe` | Transcribe one homework photo to text (never solves) |
| POST | `/api/document-ingest` | Extract text from a document and run a dialectical audit |
| GET | `/p/{id}/claims.json` | Read claim rows |
| HEAD | `/p/{id}/claims.json` | Read status and headers without a response body |
| GET | `/p/{id}/citation.json` | Cite this check |
| HEAD | `/p/{id}/citation.json` | Read status and headers without a response body |
| GET | `/api/proof-link` | Read a persisted adjudicated answer |
| POST | `/api/proof-link` | Mint a durable /p/<id> permalink (free with a session), or publish one you own |
| GET | `/p/{id}` | Shareable permalink page for a persisted answer |
| GET | `/p/{id}.json` | Machine-readable proof record for a persisted answer |
| GET | `/api/ecca-key` | The signed-in developer's key state |
| POST | `/api/ecca-key` | Create or revoke a key (signed-in account) |
| POST | `/api/checkout` | Create a Stripe Checkout Session for the signed-in account (gated) |
| GET | `/api/entitlement` | The caller's tier and feature map |
| GET | `/api/export-traces` | Export stored solve traces as NDJSON (gated: operator export token) |
| GET | `/api/capability-status` | Per-capability config truth for this deployment |
| GET | `/api/health` | Uptime probe |
| GET | `/ops/status` | Operator release status page (operator-only) |
| POST | `/ops/self-check` | Run the when-it-lands self-check (operator-only) |
| GET | `/api/trap-radar` | Trap Radar: how often questions like this split the AIs |
| POST | `/api/trap-radar` | Trap Radar (question in the body) |
| GET | `/api/miss-counter` | Miss counter: how often the AIs agreed and still did not match the key |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/eccaai-com/openapi/_original/eccaai-com-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/eccaai-com/json-schema/eccaai-com-solve-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/eccaai-com/json-schema/eccaai-com-solve-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/eccaai-com/json-schema/eccaai-com-atomic-claim-record-schema.json
- **JSONSchema** — https://artifacts.apis.io/eccaai-com/json-schema/eccaai-com-proof-machine-record-schema.json
- **JSONSchema** — https://artifacts.apis.io/eccaai-com/json-schema/eccaai-com-miss-counter-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/eccaai-com/json-schema/eccaai-com-proof-record-schema.json

## Other ECCA APIs (1)

- [ECCA-AI API](https://apis.io/apis/eccaai-com/ecca-ai-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/eccaai-com/ecca-ai-public-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/eccaai-com/.