Docs / API reference

The response

Every field you get back, and what to do with it.

{
  "ok": true,
  "claims_checked": 1,
  "claims_awaiting_editor": 0,
  "needs_editor": false,
  "claims": [{
    "claim": "Nigeria became independent in 1960.",
    "status": "checked",
    "verdict": "verified_true",
    "confidence": "high",
    "confidence_score": 95,
    "summary": "Multiple sources confirm...",
    "what_would_be_accurate": "None needed.",
    "sources_cited": 3,
    "sources": [{ "publisher": "...", "domain": "...", "url": "https://...", "stance": "supports" }],
    "text": "Ready-to-publish write-up in your house style",
    "disclosure": "This check was produced and approved by AI...",
    "review_state": "ai_approved",
    "fact_check_id": "...",
    "previously_checked": false
  }],
  "formatter_warnings": [],
  "api": { "used": 12, "limit": 100, "overage": false, "plan": "free" }
}

Top level

Field	Meaning
`claims_checked`	How many claims were found and checked.
`claims_awaiting_editor`	How many are held for your editor.
`needs_editor`	`true` if any claim is held.
`formatter_warnings`	If not empty, read it. See below.
`api.used` / `api.limit`	Your use this month and your allowance.

Each claim

Field	Meaning
`status`	`checked` (has a verdict) or `not_yet_confirmed` (held, no verdict).
`verdict`	One of the nine verdicts. Empty for a held claim.
`confidence`, `confidence_score`	How sure it is: low, medium or high, and a score from 0 to 100.
`summary`	What the evidence showed, in plain words.
`what_would_be_accurate`	A corrected statement, when the claim was wrong.
`sources`	Links, publisher and stance (supports, disputes, neutral).
`text`	The finished write-up, in your house style and language.
`disclosure`	The AI disclosure line. Publish it with the write-up.
`review_state`	`ai_approved`, `pending_human` (held) or `system_failure`.
`fact_check_id`	A stable ID for the check. Quote it when asking for support.

Always read formatter_warningsIf formatter_warnings says the formatter did not run, text and disclosure will be empty. The verdict is still valid, but do not publish a write-up that is missing its disclosure. Send the check again.

Rules for publishing

Never show a held claim as a finding.
Always publish the disclosure with the text.
Link the sources you rely on.

PreviousGET /v1/job/{id}NextVerdicts and confidence