{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/api-ninjas-com/json-schema/api-ninjas-com-bible-verify-response-schema.json",
  "title": "BibleVerifyResponse",
  "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/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."
    }
  },
  "$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"
        }
      }
    },
    "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."
        }
      }
    }
  }
}