← Documentation

Reason Codes

Stable machine-readable explanations for verification outcomes.

{
  "version": "2026-08-v6",
  "schema_version": "1.0",
  "codes": [
    {
      "code": "SOURCE_DIRECTLY_SUPPORTS_CLAIM",
      "description": "The supplied source directly establishes the material factual claim.",
      "typical_verdicts": [
        "supported"
      ],
      "recommended_action": "safe_to_use_as_cited"
    },
    {
      "code": "SOURCE_PARTIALLY_SUPPORTS_CLAIM",
      "description": "The source establishes a material part but not the complete claim.",
      "typical_verdicts": [
        "partially_supported"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "SOURCE_DOES_NOT_CONTAIN_FACT",
      "description": "The supplied source does not contain the claimed fact.",
      "typical_verdicts": [
        "unsupported"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "SOURCE_CONTAINS_RELATED_BUT_INSUFFICIENT_FACT",
      "description": "The source is related but does not establish the material claim.",
      "typical_verdicts": [
        "unsupported"
      ],
      "recommended_action": "seek_additional_evidence"
    },
    {
      "code": "AUTHORITATIVE_SOURCE_CONFLICT",
      "description": "Authoritative evidence conflicts with the submitted claim.",
      "typical_verdicts": [
        "contradicted"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "NUMERIC_CONTRADICTION",
      "description": "A deterministic numerical comparison conflicts with the submitted claim.",
      "typical_verdicts": [
        "contradicted"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "DATE_MISMATCH",
      "description": "A material date differs from the claim or requested time context.",
      "typical_verdicts": [
        "outdated"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "TEMPORAL_OUTDATEDNESS",
      "description": "The evidence supports an earlier state but not the current requested context.",
      "typical_verdicts": [
        "outdated"
      ],
      "recommended_action": "source_outdated"
    },
    {
      "code": "SCOPE_OVERSTATEMENT",
      "description": "The claim is broader than the evidence supports.",
      "typical_verdicts": [
        "partially_supported"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "CAUSAL_INFERENCE_NOT_SUPPORTED",
      "description": "The evidence does not establish the claimed causal relationship.",
      "typical_verdicts": [
        "unverifiable"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "QUANTITY_OVERSTATEMENT",
      "description": "The claim states a materially larger quantity than the evidence.",
      "typical_verdicts": [
        "unverifiable"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "MATERIAL_QUALIFIER_MISSING",
      "description": "A qualifier necessary for accuracy is omitted.",
      "typical_verdicts": [
        "unverifiable"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "CITATION_MISMATCH",
      "description": "The citation does not match the asserted fact.",
      "typical_verdicts": [
        "unsupported"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "SOURCE_INACCESSIBLE",
      "description": "The supplied source could not be retrieved safely.",
      "typical_verdicts": [
        "unverifiable"
      ],
      "recommended_action": "seek_additional_evidence"
    },
    {
      "code": "SOURCE_AMBIGUOUS",
      "description": "The source wording is too ambiguous for the claimed interpretation.",
      "typical_verdicts": [
        "unverifiable"
      ],
      "recommended_action": "seek_additional_evidence"
    },
    {
      "code": "INSUFFICIENT_EVIDENCE",
      "description": "Available evidence is insufficient for a reliable determination.",
      "typical_verdicts": [
        "unverifiable"
      ],
      "recommended_action": "seek_additional_evidence"
    },
    {
      "code": "COMPOUND_CLAIM",
      "description": "The submission contains multiple material factual claims and must be split.",
      "typical_verdicts": [
        "unverifiable"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "DETERMINISTIC_CHECK_CONFLICT",
      "description": "A deterministic check conflicts with a non-deterministic interpretation.",
      "typical_verdicts": [
        "contradicted"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "MULTI_SOURCE_CONFLICT",
      "description": "Multiple sources materially disagree.",
      "typical_verdicts": [
        "unverifiable"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "MODEL_DISAGREEMENT_UNRESOLVED",
      "description": "Structured verifier disagreement could not be resolved from evidence.",
      "typical_verdicts": [
        "unverifiable"
      ],
      "recommended_action": "revise_before_use"
    },
    {
      "code": "VERIFICATION_BUDGET_EXHAUSTED",
      "description": "The authorized verification budget ended before required assurance was achieved.",
      "typical_verdicts": [
        "unverifiable"
      ],
      "recommended_action": "revise_before_use"
    }
  ]
}

Machine-readable response