{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/api-ninjas-com/json-schema/api-ninjas-com-bible-passage-response-schema.json",
  "title": "BiblePassageResponse",
  "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/BiblePassageResponse",
  "type": "object",
  "properties": {
    "reference": {
      "type": "string",
      "description": "The references returned, in standard form, separated by \"; \"."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "With daily=true: the date of the verse of the day."
    },
    "passages": {
      "type": "array",
      "description": "One passage for each reference and translation, in the order requested.",
      "items": {
        "$ref": "#/$defs/BiblePassage"
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/BibleWarning"
      }
    }
  },
  "$defs": {
    "BiblePassage": {
      "type": "object",
      "properties": {
        "reference": {
          "type": "string"
        },
        "translation": {
          "$ref": "#/$defs/BibleTranslationInfo"
        },
        "book": {
          "type": "string",
          "description": "Book name in the translation's own language."
        },
        "book_code": {
          "type": "string",
          "description": "Standard three-character book code, the same in every translation."
        },
        "text": {
          "type": "string",
          "description": "The whole passage as one string, with verse numbers in brackets unless include_verse_numbers=false."
        },
        "verses": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/BibleVerse"
          }
        },
        "previous": {
          "type": [
            "string",
            "null"
          ],
          "description": "The reference just before the passage (the previous chapter for whole-chapter requests)."
        },
        "next": {
          "type": [
            "string",
            "null"
          ],
          "description": "The reference just after the passage (the next chapter for whole-chapter requests)."
        }
      }
    },
    "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."
        }
      }
    },
    "BibleVerse": {
      "type": "object",
      "properties": {
        "chapter": {
          "type": "integer"
        },
        "verse": {
          "type": "integer"
        },
        "verse_end": {
          "type": "integer",
          "description": "When a translation combines several verses into one, the last verse number it covers."
        },
        "text": {
          "type": "string",
          "description": "The verse text."
        },
        "headings": {
          "type": "array",
          "description": "With include_formatting=true: headings before the verse.",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "section",
                  "subsection",
                  "major",
                  "psalm_title",
                  "speaker",
                  "acrostic"
                ]
              },
              "text": {
                "type": "string"
              }
            }
          }
        },
        "paragraph_start": {
          "type": "boolean",
          "description": "With include_formatting=true: true when a new paragraph starts at this verse."
        },
        "lines": {
          "type": "array",
          "description": "With include_formatting=true: poetry lines.",
          "items": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string"
              },
              "indent": {
                "type": "integer"
              }
            }
          }
        },
        "words_of_jesus": {
          "type": "array",
          "description": "With include_formatting=true, in red-letter translations such as kjv and web: the words of Jesus as character positions in the verse text.",
          "items": {
            "type": "object",
            "properties": {
              "start": {
                "type": "integer"
              },
              "end": {
                "type": "integer"
              },
              "text": {
                "type": "string"
              }
            }
          }
        },
        "footnotes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "With include_footnotes=true: the verse's footnotes."
        },
        "words": {
          "type": "array",
          "description": "With include_strongs=true: the verse's words in order with their Strong's numbers.",
          "items": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string"
              },
              "strongs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "BibleWarning": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "VERSE_NOT_IN_TRANSLATION",
            "NUMBERING_DIFFERS",
            "BOOK_NOT_IN_TRANSLATION",
            "RANGE_CLAMPED",
            "PARTIAL_VERSE",
            "OPEN_RANGE",
            "PARTIAL_MATCH",
            "SEMANTIC_NOT_AVAILABLE"
          ]
        },
        "message": {
          "type": "string"
        }
      }
    }
  }
}