At a glance
| Base URL | https://api.calibratedagents.com |
| Authentication | Authorization: Bearer $CA_API_KEY — create a key in the console → API keys |
| Format | JSON in, JSON out, over HTTPS |
| Free allowance | 1,000,000 tokens a day · no card |
| Specification | /api/openapi.json · OpenAPI 3.1 |
| For AI coding agents | /llms.txt lists every page |
Endpoints
| Endpoint | What it does | |
|---|---|---|
POST /v1/ground/basic | Check one answer: one calibrated score, and for every wrong claim, why, where and the fix. | Docs → |
POST /v1/ground/basic/batch | Check several answers in one call. | Docs → |
GET /v1/health | Is the API up? Returns ok and the time it was checked. | Docs → |
Your first call
Create a key in the console, set it as CA_API_KEY, then:
curl -s https://api.calibratedagents.com/v1/ground/basic \
-H "Authorization: Bearer $CA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question": "Can I prepay my personal loan after six months?",
"context": ["Prepayment is allowed after 12 EMIs."],
"answer": "You can prepay after 6 EMIs."}'The claim scores about 0.97 — confidently wrong — and its receipt says 12. What the response means →