{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/api-ninjas-com/json-schema/api-ninjas-com-bible-verify-text-response-schema.json",
  "title": "BibleVerifyTextResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/api-ninjas-com-bible-api-openapi.yml#/components/schemas/BibleVerifyTextResponse",
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "description": "Number of references found."
    },
    "references": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/BibleTextReference"
      }
    }
  },
  "$defs": {
    "BibleDiffRun": {
      "type": "object",
      "description": "A run of words: same (text), changed (quote and bible), missing (bible words the quote leaves out) or extra (quote words not in the Bible text).",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "same",
            "changed",
            "missing",
            "extra"
          ]
        },
        "text": {
          "type": "string"
        },
        "quote": {
          "type": "string"
        },
        "bible": {
          "type": "string"
        }
      }
    },
    "BibleOtherMatch": {
      "type": "object",
      "properties": {
        "reference": {
          "type": "string"
        },
        "translation": {
          "type": "string",
          "description": "Translation id."
        },
        "similarity": {
          "type": "number"
        }
      }
    },
    "BibleTextReference": {
      "type": "object",
      "properties": {
        "reference": {
          "type": "string"
        },
        "start": {
          "type": "integer",
          "description": "Character position in text where the reference starts."
        },
        "end": {
          "type": "integer",
          "description": "Character position in text just after the reference."
        },
        "matched_text": {
          "type": "string",
          "description": "The reference as written in text."
        },
        "valid": {
          "type": "boolean",
          "description": "True when the reference exists."
        },
        "note": {
          "type": "string",
          "description": "When valid is false: why."
        },
        "quote": {
          "type": [
            "string",
            "null"
          ],
          "description": "The quotation next to the reference."
        },
        "verification": {
          "allOf": [
            {
              "$ref": "#/$defs/BibleVerifyResponse"
            }
          ],
          "description": "The check of that quotation, or null when there is no quotation next to the reference."
        }
      }
    },
    "BibleTranslationInfo": {
      "type": "object",
      "description": "The translation: id, name and language code.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Translation id."
        },
        "name": {
          "type": "string"
        },
        "language": {
          "type": "string",
          "description": "Language code, e.g. en, es or zh-Hans."
        }
      }
    },
    "BibleVerifyResponse": {
      "type": "object",
      "properties": {
        "quote": {
          "type": "string"
        },
        "claimed_reference": {
          "type": [
            "string",
            "null"
          ],
          "description": "When ref is sent: the claimed reference, in standard form."
        },
        "verdict": {
          "type": "string",
          "enum": [
            "exact",
            "partial",
            "minor_variation",
            "paraphrase",
            "wrong_reference",
            "not_found",
            "known_non_biblical"
          ],
          "description": "exact: a complete verse word for word. partial: exact words covering part of a verse. minor_variation: a few words differ. paraphrase: same meaning, different wording. wrong_reference: real words at a different reference than ref. not_found: no matching verse. known_non_biblical: a popular saying that is not in the Bible (see note)."
        },
        "reference": {
          "type": [
            "string",
            "null"
          ],
          "description": "Where the words actually are."
        },
        "translation": {
          "$ref": "#/$defs/BibleTranslationInfo"
        },
        "bible_text": {
          "type": "string",
          "description": "The Bible text at reference in that translation."
        },
        "similarity": {
          "type": [
            "number",
            "null"
          ],
          "description": "How closely the words match bible_text, from 0 to 1."
        },
        "meaning_similarity": {
          "type": "number",
          "description": "When the quote matches a verse by meaning rather than wording: how close the meaning is, from 0 to 1 (similarity is then null)."
        },
        "diff": {
          "type": "array",
          "description": "Word-by-word comparison with bible_text. Omitted for exact matches.",
          "items": {
            "$ref": "#/$defs/BibleDiffRun"
          }
        },
        "other_matches": {
          "type": "array",
          "description": "Up to three matches in other translations.",
          "items": {
            "$ref": "#/$defs/BibleOtherMatch"
          }
        },
        "note": {
          "type": "string",
          "description": "An explanation, when useful, e.g. where a known non-biblical saying comes from."
        }
      }
    }
  }
}