# citation.is

> Independent, anchored audits of AI-drafted documents. A panel of models with
> no stake in your draft verdicts every checkable claim: VERIFIED, FLAGGED, or
> ABSTAINED. Every verdict is deposited to a hash-chained, Bitcoin-timestamped
> ledger BEFORE it is shown. If panel agreement falls below the statutory floor
> (kappa_min = 0.6), the audit is ruled inadmissible and no verdicts issue.

This service is built for LLMs and agents: an AI can verify what an AI wrote.

## Free agent access (no key required)

- `POST https://citation.is/api/audit/async` — free: 50 audits/day per IP.
  202 immediately: {"audit_id", "status_url"}. Poll
  `GET /api/audit/status/{audit_id}` until status=done; the receipt deposit_id
  and receipt_url fill in. Built for agents whose patience is measured in
  connection pools.
- Optional persistent identity: `POST https://citation.is/api/keys/register`
  self-issues a ciak_ Bearer key with 5 bonus credits (one per IP per 24h).
  Header `Authorization: Bearer ciak_...` on audit calls.
- `GET https://citation.is/api/balance` (Bearer) — balance, price,
  audits_remaining.
- Errors: 429 = daily free tier exhausted (resets at UTC midnight).

## Paid agent access (prepaid keys)

- `POST https://citation.is/api/audit/async` (Bearer) — 202 immediately:
  {"audit_id", "status_url"}. Poll
  `GET /api/audit/status/{audit_id}` until
  status=done; the receipt deposit_id and receipt_url fill in. Built for agents
  whose patience is measured in connection pools.
- Header `Authorization: Bearer ciak_...` — prepaid key: 1 cent per audit,
  no IP quota. Without a key: 5 audits/day per IP (free probe tier).
- `GET https://citation.is/api/balance` (Bearer) — balance, price,
  audits_remaining.
- Keys are issued by the founder (machine billing, no invoices):
  https://citation.is/#start
- Errors: 402 = insufficient balance (top up); 429 = free tier exhausted.

## Endpoints

- `POST https://citation.is/api/audit` — submit a document for audit.
  Body (JSON): {"document_text": "...", "task_class": "doc-draft",
  "provider_id": "optional"}
  Response: a receipt JSON (same schema as GET /api/r/{id}). Latency ~60-100 s.
  Rate limit: 5 audits per IP per day without a key; unlimited with a
  prepaid Bearer key (1 cent/audit). Async variant: POST /api/audit/async.
- `GET https://citation.is/api/r/{receipt_id}` — receipt as raw JSON.
- `GET https://citation.is/r/{receipt_id}` — same receipt as a human page.
- `GET https://citation.is/api/health` — liveness + endpoint map.

## Receipt semantics

- `verdict_counts`: VERIFIED (checks out), FLAGGED (conflicts with record),
  ABSTAINED (cannot be known from the document — nobody bluffs).
- `panel.kappa` vs `panel.kappa_min_law`: agreement below floor =>
  `admissible: false`, no verdicts.
- `anchor`: ledger sequence + hash; OTS (OpenTimestamps) status. The ledger
  stores hashes only, never document text.
- `disclosure`, `boundary`, `blind_spot`: statutory texts — evidence and
  monitoring only; not certification; catches sustained betrayal, not a single
  poisoned answer.

## Example receipt (a genuine refusal)

https://citation.is/api/r/9114e78c-109b-48af-968b-546c476a8aed — panel
agreement collapsed (kappa 0.481 < 0.6), audit ruled itself inadmissible.

## Pricing

2% of the client's AI spend, per the published Audit-Rate Schedule v1.0
(tiered by provider track record). Rate law hash-anchored and
Bitcoin-timestamped.

## Top agent (chat)

- `POST https://citation.is/a/chat` {"message": "...", "history": [...]} — the service's voice.
  Paste a document (>600 chars) to run a full audit and get the receipt; paste a receipt
  URL or id to have it read; ask questions otherwise. 20 messages/IP/day.
- `GET https://citation.is/a` — the same agent as a minimal human chat page.

## Knowledge Hub: Citation in the Age of AI
- /citation/ — hub index
- /citation/what-is-citation (md: /citation/what-is-citation.md)
- /citation/ai-citation-crisis (md: /citation/ai-citation-crisis.md)
- /citation/how-ai-cites (md: /citation/how-ai-cites.md)
- /citation/machine-citation (md: /citation/machine-citation.md)
- /citation/verification (md: /citation/verification.md)