# IQ Bible API Documentation ## The IQ Bible API Features Over 50 Endpoints for Comprehensive Biblical Integration --- ## Version: 1.36.1 | December 8, 2024 --- ### What's New in This Version --- In version 1.36.1, we've introduced exciting new features and enhancements to expand the API's capabilities and provide more in-depth biblical insights. These updates are designed to improve functionality and offer greater flexibility for developers. - **`GetSemanticRelations`**: A brand-new endpoint that provides semantic relationships between biblical terms and concepts. This tool helps developers build context-aware applications by identifying connections between key biblical themes and terms. - **`GetVerseCount`**: Enhanced to support an optional `versionId` parameter, allowing you to retrieve verse counts for different Bible translations. If no version is specified, the endpoint defaults to the King James Version (KJV). This update accounts for variations in verse counts across translations. _For detailed information on these endpoints, please see the 'Get Requests' sections below._ --- ## Welcome to the IQ Bible API: Integrating Faith and Technology The IQ Bible API, hosted on the RapidAPI marketplace, is tailored for developers and creators aiming to incorporate Christian teachings, scriptures, and aspects of Jesus' life into digital platforms. This API acts as a conduit between modern technology and the rich tapestry of faith, providing a diverse array of tools and resources. Whether your goal is to delve into religious texts for personal exploration or to share the essence of Christianity through applications, our API is equipped to support your journey. ### Key Features: - **Audio Narrations**: Enhance user engagement with professional audio narrations, offering an auditory journey through the Bible. - **Scriptures and Teachings of Jesus**: Access a wide variety of Biblical scriptures, including teachings and parables of Jesus Christ, in multiple languages like English, Spanish, and Arabic. - **Professional Audio Narrations**: Immerse your users in the Word of God with high-quality audio narrations of the Bible, bringing the stories of Jesus and Christian teachings to life. - **Original Biblical Texts**: Dive into the historical roots of Christianity with access to original Hebrew and Greek texts, essential for scholarly and theological studies. - **Strong’s Concordance and Cross-References**: Integrate comprehensive study tools including Strong's Concordance for in-depth Biblical research, along with cross-references for a holistic understanding of Christian doctrines. - **Extra-Biblical Books**: Explore a rich collection of extra-biblical texts, offering deeper insights into ancient religious contexts and narratives beyond the canonical scriptures. - **Advanced Search Capabilities**: Equip your application with powerful search features to explore topics related to Jesus, Christian beliefs, and Biblical narratives. ## Versatile and Developer-Friendly Whether you're building applications for a church, Christian educational platform, or personal spiritual growth, the IQ Bible API is versatile and easy to integrate, offering REST-style JSON responses and detailed documentation. ### Engage and Inspire a Faith-Based Community Our API is more than a tool; it's a platform to inspire and engage with a community deeply interested in the Christian faith, Bible studies, and the life of Jesus. [Start integrating the IQ Bible API in your projects today](https://rapidapi.com/vibrantmiami/api/iq-bible/) --- ## Need More Information or Support? For any inquiries or assistance, reach out to me at: - Email: [jody@websitie.com](mailto:jody@websitie.com) - Website: [JodyPM.com](https://jodypm.com) - Let's talk: [Schedule a call](https://jodypm.com/contact.php). Learn more about us: - [IQ Bible Website](https://iqbible.com) - [Websitie.com](https://websitie.com) - [JodyPM.com](https://jodypm.com) ---
--- ## Get Requests In this section, we provide a comprehensive overview of the 'Get' requests available through the IQ Bible API. Each endpoint is designed to facilitate easy access to a wide range of Biblical data and resources. Whether you're looking to retrieve specific scriptures, audio narrations, or perform advanced searches, these endpoints offer the necessary functionality to integrate Biblical content seamlessly into your application. Below, you will find detailed descriptions of each endpoint, including their purpose, usage, and example requests and responses to help you get started. ---

### GetAudioNarration **Description:** Returns the audio narration file for the Bible chapter in the version specified. Currently supported versions: KJV, RV1909 (Reina Valera 1909 (Spanish)), and SVD (Smith-Van Dyke (Arabic)). The response can be utilized in an audio element to allow the users of your app to listen to complete chapters of the Bible professionally narrated. Important note: Do not hard-code the URL of the audio file returned by this endpoint as the URLs change periodically. This endpoint should always be called first to ascertain the correct URL for the filename. If you hard-code the URLs and that URL changes later, your audio narration won't work and will thus plague your users with a poor User Experience (UX). Always call this endpoint first, and then use the responding URL in your implementation. **Headers:** Content-Type: application/json **Parameters:** - `bookId`: Integer - `chapterId`: Integer - `versionId`: String (e.g., 'rv1909') *Example request:* `GetAudioNarration?bookId=01&chapterId=02&versionId=kjv` *Example response:* `{"fileName":"https:\/\/2-us.com\/media\/audio\/narrations\/obf-kjv\/kjv-dw-01002-0yFiZ1R8cv.mp3"}`

### GetBibleBookAbbreviations **Description:** GetBibleBookAbbreviations will return an array of all the abbreviations for bible book names. Also see, GetParseCitation. **Headers:** Content-Type: application/json **Parameters:** - N/A *Example request:* `GetBibleBookAbbreviations?` *Example response:* `[["Genesis","Gen.","Ge.","Gn."],["Exodus","Ex.","Exod.","Exo."],["Leviticus","Lev.","Le.","Lv."],["Numbers","Num.","Nu.","Nm.","Nb."], ... ]]`

### GetBibleReadingPlan **Description:** GetBibleReadingPlan will return a Bible reading plan dividing the Bible into chapters according to the days specified. There are optional parameters that you can set after the required 'days' parameter, namely, 'requestedStartDate', 'sections', and 'requestedAge'. The initial values of the response are the days requested ('daysRequested') of the plan and the days actually filled ('daysFilled'). This is to denote a disparity in the requested days and actually filled days for an event such as requesting a plan for 365 days of the New Testament only (the 'sections' parameter): As there are only 260 chapters in the New Testament, we can't fill all 365 days with 260 chapters. The 'sections' parameter can be set to 'OT' or 'NT' for either the Old or New testaments. If this is not set, the default is both, signified by the 'OT+NT' value. The sub-array 'datesInfo' contains today's date ('todaysDate'), the date the plan starts ('startDate') (if set), how many days until the start date ('daysUntilStartDate'), and the ending date of the plan ('endDate'). The 'chaptersInfo' key holds the values for the total number of chapters of the plan ('totalChapters'), the average number of chapters that will be read per day ('averageChaptersPerDay'), and the most ('mostChapters') and least chapters ('leastChapters') that will be encountered; each having an additional sub-array of information such as what days and dates the most and least chapters will be read on. The 'readingTime' key holds arrays concerning the average time, based on the reader's age ('readersAge') of the plan. The 'requestedAge' is the value of the parameter 'requestedAge', and the 'readersAge' may be the same as long as the 'requestedAge' is valid and above the value of '6', which is the default age. This array gathers its date from the 'GetReadingTimeByAge' endpoint, q.v., differentiating between silent and oral reading. For the Bible reading plan endpoint, only averages will be returned, but the 'GetReadingTimeByAge' if called separately is more precise. Note: Please see the description of the 'GetReadingTimeByAge' endpoint for calculations of reading times beyond the age of 18, where we humans normally reach our peak. After these preliminary arrays, the response is then divided into a key for each day of the plan encompassing the day number ('day'), the 'date' of that day, and all of the chapters ('bookAndChapterIds') to be read on that day. These 'bookAndChapterIds' can be called with the 'GetChapterByBookAndChapterId' endpoint, which will return the entire chapter - just as with the 'GetChapter' endpoint (which uses different parameters). Lastly, if you want to also pull the names (such as 'Genesis 1') instead of '01001', this can be achieved via the 'GetBookAndChapterNameByBookAndChapterId', which see. Also, see the following endpoints: GetReadingTimeByAge GetChapterByBookAndChapterId GetBookAndChapterNameByBookAndChapterId GetWordCountOfChapter **Headers:** Content-Type: application/json **Parameters:** - `days`: Integer - `requestedStartDate`: Date (format: YYYY-MM-DD) - `sections`: String (e.g., 'nt') - `requestedAge`: Integer *Example request:* `GetBibleReadingPlan?days=180&requestedStartDate=2023-01-01§ions=nt&requestedAge=17` *Example response:* `[{"daysRequested":"180","daysFilled":"180","sections":"nt","datesInfo":{"todaysDate":"2022-11-28","startDate":"2023-01-01","daysUntilStartDate":34,"endDate":"2023-06-30"},"chaptersInfo":{"totalChapters":260, ...`

### GetBibleReadingPlanByTopic **Description:** This endpoint will return a Bible Reading Plan specific to the value of the 'topic' parameter. Please note that when using this endpoint, not as many days can be assigned per the 'days' parameter as with the 'GetBibleReadingPlan' endpoint, but you can easily ascertain how many 'verseIds' any topic will produce by using the 'GetTopicVerseCount' endpoint (e.g., GetTopicVerseCount?topic=angels). If the 'days' parameter is not set, the value will default to '30'. If the 'topic' parameter is not set, the default will be the first topic (addiction). Topics (97): addiction, adultery, afterlife, alcohol, animals, anger, angels, anxiety, baptism, birth, business, charity, children, church, compassion, courage, dating, death, deliverance, devil, depression, discipleship, divorce, drugs, endurance, eternal life, evil, faith, faithfulness, family, fasting, fear, forgiveness, friendship, food, generosity, good, gospel, gossip, government, grace, gratitude, guidance, healing, health, holiness, homosexuality, hope, humility, idolatry, ignorance, integrity, jealousy, joy, justice, kindness, kingdom of god, life, love, marriage, medicine, money, miracles, obedience, patience, peace, perseverance, politics, praise, prayer, predestination, prophecy, purpose, racism, redemption, renewal, repentance, resurrection, righteousness, sacrifice, satan, salvation, science, second coming, servanthood, sex, stress, suffering, suicide, temptation, trust, truth, unity, wealth, wisdom, worrying, and worship. Also, see the following endpoints: GetTopics GetTopicVerseCount GetBibleReadingPlan GetChapterByBookAndChapterId GetBookAndChapterNameByBookAndChapterId **Headers:** Content-Type: application/json **Parameters:** - `topic`: String - `days`: Integer (optional) - `requestedStartDate`: Date (format: YYYY-MM-DD) (optional) *Example request:* `GetBibleReadingPlanByTopic?topic=love&days=30&requestedStartDate=2025-01-01` *Example response:* `{"topicInfo":{"topic":"love","daysRequested":"30","daysFilled":26},"readingPlan":[{"day":1,"date":"2025-01-01","verseIds":["46013004","46013005","46013006","46013007","46013008","46016014"]},{"day":2,"date":"2025-01-02","verseIds":["43003016","62004008","60004008","51003014","46013013","43015013"]} ...`

### GetBookAndChapterNameByBookAndChapterId **Description:** Returns the name of the book and chapter as specified in the 'bookAndChapterId' and 'language' parameter values. Both parameters are required. This endpoint will now validate any submissions (e.g., if an incorrect 'bookAndChapterId' is submitted, it will return empty; whereas, previously, it would return the correct book name with an and incorrect chapter number). **Headers:** Content-Type: application/json **Parameters:** - `bookAndChapterId`: String (e.g., '01001') - `language`: String (e.g., 'english') *Example request:* `GetBookAndChapterNameByBookAndChapterId?bookAndChapterId=01001&language=english` *Example response:* `"Genesis 1"`

### GetBooks **Description:** Returns a list of all of the books of the Bible in the language specified with the '?language=[language]' parameter. Currently supported languages are English, Spanish, and Arabic; with more on the way. **Headers:** Content-Type: application/json **Parameters:** - `language`: String (e.g., 'english') *Example request:* `GetBooks?language=english` *Example response:* `[{"b":"1","n":"Genesis"},{"b":"2","n":"Exodus"},{"b":"3","n":"Leviticus"},{"b":"4","n":"Numbers"}, ... }]`

### GetBookIdByBookName **Description:** Returns the 'bookId' of the 'bookName' submitted. At this time, abbreviations, such as with the 'GetParseCitation' endpoint are not supported but will be in the future. English, Spanish, and Arabic book names are supported. **Headers:** Content-Type: application/json **Parameters:** - `bookName`: String - `language`: String (e.g., 'english') *Example request:* `GetBookIdByBookName?bookName=John&language=english` *Example response:* `"43"`

### GetBooksNT **Description:** Returns a list of only the New Testament books in the language specified with the '?language=[language]' parameter. **Headers:** Content-Type: application/json **Parameters:** - `language`: String (e.g., 'english') *Example request:* `GetBooksNT?language=english` *Example response:* `[{"b":"40","n":"Matthew","t":"NT","g":"5"},{"b":"41","n":"Mark", ... }]`

### GetBooksOT **Description:** Returns a list of only the New Testament books in the language specified with the '?language=[language]' parameter. **Headers:** Content-Type: application/json **Parameters:** - `language`: String (e.g., 'english') *Example request:* `GetBooksOT?language=english` *Example response:* `[{"b":"1","n":"Genesis","t":"OT","g":"1"},{"b":"2","n":"Exodus","t":"OT","g":"1"}, ... }]`

### GetBooksExtraBiblical **Description:** This endpoint retrieves a list of all the extra-biblical books available in our database. These works are not part of the standard biblical canon but are valued for their historical and religious insights. They include various genres like prophecies, wisdom literature, and additional narratives that offer a broader understanding of ancient religious and cultural contexts. While not considered canonical in many religious traditions, they are often studied for their historical significance and their influence on religious thought and tradition. These books are: - 1st Enoch ("Ethiopic" Book of Enoch) - 2nd Enoch ("Slavonic" "Secrets of Enoch") - 3nd Enoch ("Hebrew" Book of Enoch) - 1st and 2nd Book of Adam and Eve - Jashar - Jubilees - Tobit - Judith - Esther (Greek) - Wisdom - Ecclesiasticus - Song of Three - Susanna - Bel and the Dragon - 1 Maccabees - 2 Maccabees - 1 Esdras - 2 Esdras - Manasseh - 1 Hermas - 2 Hermas - 3 Hermas - Testament of Solomon - Apocalypse of Peter - Testaments of the Twelve Patriarchs - The Ascension of Isaiah - The Apocalipse of Sedrach - 1 Baruch - 2 Baruch - 3 Baruch - 4 Baruch The chapters for any book can be retrieved using the 'GetChapterExtraBiblical' endpoint with the 'bookId' and 'chapterId' parameters. Only English is currently supported. Also see: GetChapterExtraBiblical **Headers:** Content-Type: application/json **Parameters:** - N/A *Example request:* `GetBooksExtraBiblical` *Example response:* `[{"id":"1","weight":"1","name":"1 Enoch","info_text":"","info_url":"https:\/\/en.wikipedia.org\/wiki\/Book_of_Enoch","path":"1-enoch\/1-enoch"}...}]`

### GetBookInfo - NEW! **Description:** This endpoint retrieves detailed information for a specified canonical biblical book based on the provided `bookId` and language setting. The data includes both general and theological information about the book, offering an in-depth resource for applications focused on biblical studies, teaching, theological, and thematic exploration. The information spans various aspects such as book structure, themes, historical context, theological significance, and major characters, with additional insights on covenantal themes, symbolism, and eschatological perspectives. The endpoint currently supports English (`language=english`) as the default and only available language. **Headers:** - `Content-Type`: `application/json` **Parameters:** - `bookId` (required, integer): Specifies the biblical book ID. Ranges from `01` (Genesis) to `66` (Revelation). - `language` (optional, string): Specifies the language for the response data. Currently, only `"english"` is available. *Example request:* `GetBookInfo?bookId=40&language=english` *Example response:* `[{"bookId":"40","chapterCount":28,"introduction":"The Gospel of Matthew presents Jesus as the promised Messiah...","introduction_long":"The Gospel of Matthew is a foundational book in the New Testament...","author":"Traditionally attributed to Matthew, the tax collector","date":"Circa a.d. 60-70","word_origin":"The title 'Gospel' comes from the Greek 'euangelion', meaning 'good news'.","genre":"Gospel"}...]` ### GetBookNameByBookId **Description:** Returns the name of the book per the number sent in the language specified. For example, 'GetBookNameByBookId?bookId=01&language=english' would return 'Genesis'. **Headers:** Content-Type: application/json **Parameters:** - `bookId`: Integer or String - `language`: String (e.g., 'english') *Example request:* `GetBookNameByBookId?bookId=01&language=english` *Example response:* `[{"n":"Genesis"}]`

### GetBookNameExtraBiblicalByBookId **Description:** Returns the name of an extra-biblical book per the number sent in the request. For example, sending a request to 'GetBookNameExtraBiblicalByBookId?bookId=01' would return the name of the first extra-biblical book in the configured list. **Headers:** Content-Type: application/json **Parameters:** - `bookId`: Integer or String. The ID of the extra-biblical book whose name is to be returned. *Example request:* `GetBookNameExtraBiblicalByBookId?bookId=01` *Example response:* `[{"n":"1 Enoch"}]`

### GetBookNameByVerseId **Description:** Returns the name of the book per the 'verseId' sent in the language specified. For example, 'GetBookNameByVerseId?verseId=40001001&language=english' would return 'Matthew'. **Headers:** Content-Type: application/json **Parameters:** - `verseId`: String (e.g., '02001001') - `language`: String (e.g., 'english') *Example request:* `GetBookNameByVerseId?verseId=02001001&language=english` *Example response:* `[{"n":"Matthew"}]`

### GetBookNumberByName **Description:** Returns the number of the book that corresponds to the name sent as a parameter. The full book name must be sent. **Headers:** Content-Type: application/json **Parameters:** - `bookName`: String - `language`: String (e.g., 'english') *Example request:* `GetBookNumberByName?bookName=John&language=english` *Example response:* `"43"`

### GetChapter **Description:** Returns a complete Bible chapter. Required **Parameters:** 'bookId', 'chapterId', and 'versionId'. For example, 'GetChapter?bookId=01&chapterId=02&versionId=kjv' would return the entire second chapter of Genesis in the King James Version. **Headers:** Content-Type: application/json **Parameters:** - `bookId`: Integer or String - `chapterId`: Integer - `versionId`: String (e.g., 'kjv') *Example request:* `GetChapter?bookId=01&chapterId=01&versionId=kjv` *Example response:* `[{"id":"01001001","b":"1","c":"1","v":"1","t":"In the beginning God created the heaven and the earth."},{"id":"01001002","b":"1","c":"1","v":"2","t":"And the earth was without form, and void; and darkness was upon the face of the deep. And the Spirit of God moved upon the face of the waters."}, ... }]`

### GetChapterExtraBiblical **Description:** This endpoint provides access to individual chapters from a wide range of extra-biblical texts. These texts, not included in the standard biblical canon, encompass a diverse array of writings such as apocryphal, deuterocanonical, and other ancient religious documents. They offer valuable insights into religious thought, history, and cultural practices from periods not covered in traditional biblical narratives. To retrieve a specific chapter, two parameters are required: 'bookId' and 'chapterId'. For instance, a request like 'GetChapterExtraBiblical?bookId=01&chapterId=02' fetches the second chapter of the extra-Biblical book of 1 Enoch. Also see: GetBooksExtraBiblical **Headers:** Content-Type: application/json **Parameters:** - `bookId`: Integer - `chapterId`: Integer *Example request:* `GetChapterExtraBiblical?bookId=01&chapterId=03` *Example response:* `[{"b":"1","c":"3","cs":"3","v":"1","vs":"1","t":"Observe and see how (in the winter) all the trees \u2308\u2308seem as though they had withered and shed all their leaves, except fourteen trees, which do not lose their foliage but retain the old foliage from two to three years till the new comes.\n\n"}]`

### GetChapterByBookAndChapterId **Description:** Returns a complete Bible chapter according to the 'bookAndChapterId' and 'versionId' established. Required **Parameters:** 'bookAndChapterId', and 'versionId'. For example, 'GetChapterByBookAndChapterId?bookAndChapterId=40001&versionId=kjv' will return the entire first chapter of Matthew in the King James Version. This endpoint enjoys great utility when used in conjunction with 'GetBibleReadingPlan'. Also, see the following endpoints: GetBibleReadingPlan GetBookAndChapterNameByBookAndChapterId GetChapter **Headers:** Content-Type: application/json **Parameters:** - `bookAndChapterId`: String (e.g., '40001') - `versionId`: String (e.g., 'kjv') *Example request:* `GetChapterByBookAndChapterId?bookAndChapterId=40001&versionId=kjv` *Example response:* `[{"id":"40001001","b":"40","c":"1","v":"1","t":"The book of the generation of Jesus Christ, the son of David, the son of Abraham."},{"id":"40001002","b":"40","c":"1","v":"2","t":"Abraham begat Isaac; and Isaac begat Jacob; and Jacob begat Judas and his brethren;"}, ... }]`

### GetChapterCount **Description:** Returns simply the number of chapters in any book requested via the 'bookId' parameter. For example, 'GetChapterCount?bookId=66' would return '22' as there are twenty-two (22) chapters in Revelation the 66th book. **Headers:** Content-Type: application/json **Parameters:** - `bookId`: Integer *Example request:* `GetChapterCount?bookId=66` *Example response:* `{"chapterCount":22}`

### GetChapterCountExtraBiblical **Description:** Returns the number of chapters in any extra-biblical book requested via the 'bookId' parameter. This endpoint specifically caters to the collection of extra-biblical texts. For example, a request like 'GetChapterCountExtraBiblical?bookId=1' would return the total number of chapters (107) in the extra-biblical book of 1 Enoch. **Headers:** Content-Type: application/json **Parameters:** - `bookId`: Integer. The ID of the extra-biblical book whose chapter count is being requested. *Example request:* `GetChapterCountExtraBiblical?bookId=1` *Example response:* `{"chapterCount":107}`

### GetChronological **Description:** Returns an array containing a general list of the chronological events of the Bible. **Headers:** Content-Type: application/json **Parameters:** - `language`: String (e.g., 'english') *Example request:* `GetChronological?language=english` *Example response:* `{"The Creation":"1001 B. C.","The Fall.":"(?)","The Translation of Enoch.":"3017 B. C.","The Flood.":"2348 B. C.", ... }`

### GetCommentary **Description:** Returns all of the commentaries for the 'verseId' and 'commentaryId' parameters specified. The 'commentaryId' is currently limited to 'gills'. Both parameters are required. **Headers:** Content-Type: application/json **Parameters:** - `verseId`: String (e.g., '01001001') - `commentaryName`: String (e.g., 'gills') *Example request:* `GetCommentary?verseId=01001001&commentaryName=gills ` *Example response:* `"\nIn the beginning God created the heaven and the earth. By the heaven some understand the supreme heaven, the heaven of heavens, the habitation of God, and of the holy angels; and this being made perfect at once, no mention is ... "`

### GetCrossReferences **Description:** Returns all of the complete cross-references (with starting and ending verse, if applicable) for the 'verseId' received. **Headers:** Content-Type: application/json **Parameters:** - `verseId`: String (e.g., '66001001') *Example request:* `GetCrossReferences?verseId=66001001` *Example response:* `[{"verseId":"66001001","r":"10","sv":"66022016","ev":"00000000"},{"verseId":"66001001","r":"11","sv":"66022006","ev":"00000000"}, ... }]`

### GetDefinitionBiblical **Description:** Returns the dictionary for the 'dictionaryId' parameter specified. The 'dictionaryId' is currently limited to 'smiths'. **Headers:** Content-Type: application/json **Parameters:** - `query`: String - `dictionaryId`: String (e.g., 'smiths') *Example request:* `GetDefinitionBiblical?query=solomon&dictionaryId=smiths` *Example response:* `{"word":"Solomon","definition":"(peaceful). I. Early life and occasion to the throne . --Solomon was the child of ... "}`

### GetEndpoints **Description:** Retrieves a list of all available public endpoints in the API. It's an essential tool for developers to understand the API's structure and the parameters each endpoint expects. **Headers:** Content-Type: application/json **Parameters:** - N/A *Example request:* `GetEndpoints` *Example response:* `{"GetAudioNarration":{"params":["bookId","chapterId","versionId"]},"GetAudioMusic":{"params":["genre"]}, ...}`

### GetGenres - NEW! **Description:** This endpoint retrieves the genres of book groupings within the Bible, providing the starting and ending bookId and verseId for each genre. The genres are categorized according to the section of the Bible (Old Testament, New Testament, or both). It supports genre groupings like "Law", "History", "Poetry", "Prophecy", "Gospels", and "Epistles", enabling easy, programmatic navigation for users. This functionality makes it simple to explore the Bible's traditional literary divisions and facilitates seamless access to genre-based content for applications, studies, or Bible exploration tools. The `section` parameter allows users to filter the genres by the Old Testament (OT), New Testament (NT), or both (OT + NT). **Headers:** - `Content-Type`: `application/json` **Parameters:** - `language` (optional, string): Specifies the language for the response data. Currently, only `"english"` is available. - `section` (optional, string): Specifies the section of the Bible for the response. Accepted values are: - `"ot"`: Old Testament genres only. - `"nt"`: New Testament genres only. - `"ot+nt"` or `"all"`: Both Old and New Testament genres. **Example request:** `GetGenres?section=ot+nt&language=english` **Example response:** `[{"genre":"Law","startingBookId":"01","endingBookId":"05","startingVerseId":"01001001","endingVerseId":"05034028"}] ...` ### GetGreekCharactersAndUnicode **Description:** Returns the Unicode for the Greek alphabet in both lower and uppercase. Only one parameter is taken: 'language'. **Headers:** Content-Type: application/json **Parameters:** - `language`: String (e.g., 'english') *Example request:* `GetGreekCharactersAndUnicode?language=english` *Example response:* `{"alpha":{"lowercase":"\\03b1","uppercase":"\\0391"},"beta":{"lowercase":"\\03b2","uppercase":"\\0392"},"gamma":{"lowercase":"\\03b3", ... }`

### GetHebrewCharactersAndUnicodePoints **Description:** Returns the Unicode for the Hebrew alphabet and corresponding English transliterations (based on the Unicode standard). The response includes letters, points, accents, punctuation, marks, signs, and Yiddish ligatures. Only one parameter is taken: 'language'. **Headers:** Content-Type: application/json **Parameters:** - `language`: String (e.g., 'english') *Example request:* `GetHebrewCharactersAndUnicodePoints?language=english` *Example response:* `{"letters":{"alef":"\\u05d0","bet":"\\u05d1","gimel":"\\u05d2","dalet":"\\u05d3","he":"\\u05d4","vav":"\\u05d5","zayin":"\\u05d6", ... "}`

### GetInfo **Description:** GetInfo will return information about this API. **Headers:** Content-Type: application/json **Parameters:** - N/A *Example request:* `GetInfo` *Example response:* `{"appName":"IQ Bible API","appDescription":"The IQ Bible API provides an advanced structure for procuring not only Biblical passages but data from many other theological sources.","appType":"web application API","version":"v1.9.1","parentApplication":"IQ Bible - https:\/\/iqbible.com","authors":"https:\/\/websitie.com"}`

### GetOriginalText **Description:** Will return either the Hebrew or the Greek depending on the Testament assessed from the 'verseId'. There are thirty-nine (39) books in the Old Testament (Protestant) and twenty-seven (27) in the New Testament. **Headers:** Content-Type: application/json **Parameters:** - `verseId`: String (e.g., '01001001') *Example request:* `GetOriginalText?verseId=01001001` *Example response:* `[{"id":"1","verseID":"1001001","book":"1","chapter":"1","verse":"1","word":"\u05d1\u05bc\u05b0\u05e8\u05b5\u05d0\u05e9\u05c1\u05b4\u0596\u05d9\u05ea","pronun":" ... }]`

### GetParables **Description:** Produces a list of parables in the Bible and their relative citations (e.g., 'GetParables?language=english'). The verses of the parables can be retrieved in your app by using the 'GetParseCitation' call (q.v.). For example, for the last parable, 'The Sheep and the Goats', we can retrieve the 'verseIds' for that parable with this call: 'GetParseCitation?citation=Matthew 25:31-46', and then use the 'GetVerse' endpoint to pull the text. **Headers:** Content-Type: application/json **Parameters:** - `language`: String (e.g., 'english') *Example request:* `GetParables?language=english` *Example response:* `{"Salt of the Earth":["Matthew 5:13","Mark 9:50"],"Lamp Under a Bowl":["Matthew 5:14-16","Mark 4:21-22","Luke 8:16","Luke 11:33"],"Wise and Foolish Builders":["Matthew 7:24-27","Luke 6:47-49"], ...}`

### GetParallelVerses **Description:** Returns the verse according to the 'verseId' sent in all of the versions available. **Headers:** Content-Type: application/json **Parameters:** - `verseId`: String (e.g., '01001001') *Example request:* `GetParallelVerses?verseId=01001001` *Example response:* `[[{"id":"01001001","b":"1","c":"1","v":"1","t":"In the beginning God created the heavens and the earth.","versionId":"t_asv","versionAbbreviation":"ASV","versionName":"American Standard \r\n - 1901"}], ... }]]`

### GetParseCitation **Description:** Returns all of the 'verseIds' for the citation submitted. You can use abbreviations (e.g., Ex., or Exod. for Exodus) and multiple references from the same book within the same chapter. Also, see GetBibleBookAbbreviations for an array of abbreviations. Separate individual verses by commas and use a hyphen for a range of verses. So, if we want the 2nd, 3rd, and 7th verses of Matthew chapter 1 as well as a range of verses from 10 to 14, our call would be: 'GetParseCitation?citation=Matt.1:2, 3, 7, 10-14' or 'Matthew 1:2, 3, 7, 10-14', or even, 'Mt. 1:2, 3, 7, 10-14'. Note: This endpoint does not validate the returned 'verseIds' or book name ('bookName'), nor can it be used to parse multiple verses from different books and chapters. **Headers:** Content-Type: application/json **Parameters:** - `citation`: String (e.g., 'Matt.1:2,3,7,10-14') *Example request:* `GetParseCitation?citation=Matt.1:2,3,7,10-14` *Example response:* `{"bookName":"Matthew","bookId":"40","chapterId":"001","verseIds":["40001002","40001003","40001007","40001010","40001011","40001012","40001013","40001014"]}`

### GetParseVerseId **Description:** Parses any 'verseId' to return the 'bookId', 'bookAndChapterId', 'chapterNumber', and the verse number ('verseNumber'). This endpoint will check the value of the 'verseId' submitted, so ensure that it is a valid 'verseId' and it's correctly formatted (8 digits), otherwise an empty response will be returned. For example, 'GetParseVerseId?verseId=66001001' is valid, and will return the JSON, whereas, 'GetParseVerseId?verseId=66050001' will not since there is not a chapter 50 in the book of Revelation (the 66th book (Protestant)). **Headers:** Content-Type: application/json **Parameters:** - `verseId`: String (e.g., '01001001') *Example request:* `GetParseVerseId?verseId=43003016` *Example response:* `{"verseId":"43003016","bookId":"43","bookAndChapterId":"43003","chapterNumber":"003","verseNumber":"016"}`

### GetPropheciesFulfilledInJesus **Description:** Returns the 351 prophecies of the Old Testament that were fulfilled in Jesus. Includes the scripture references in the Old and New Testaments. **Headers:** Content-Type: application/json **Parameters:** - `language`: String (e.g., 'english') *Example request:* `GetPropheciesFulfilledInJesus?language=english` *Example response:* `{"Gen 3:15":"He will bruise Satan's head. Fulfilled in: Heb 2:14; 1 John 3:8","Gen 5:24":"The bodily ascension to heaven illustrated. Fulfilled in: Mark 16:19", ... }`

### GetRandomChapter **Description:** Returns a random chapter in its entirety. **Headers:** Content-Type: application/json **Parameters:** - `versionId`: String (e.g., 'kjv') *Example request:* `GetRandomChapter?versionId=kjv` *Example response:* `[{"id":"07017001","b":"7","c":"17","v":"1","t":"And there was a man of mount Ephraim, whose name was Micah."}, ... }]`

### GetRandomVerse **Description:** Returns a random verse from the Bible (Old Testament or New Testament). The 'GetRandomVerse' has been newly updated and now features advanced filter parameters, such as limiting the random verse to the New or Old Testament, limiting the random verse to a specific book, or a specific book and chapter. For example, 'GetRandomVerse?versionId=kjv&limitToBookId=20&limitToChapterId=1' will limit to the book of Proverbs, chapter '1'. Or, 'GetRandomVerse?versionId=kjv&limitToBookId=20' will limit to the book of Proverbs, any chapter. If no parameters are added after 'versionId', a random verse from the entire Bible will be requested. You can also limit the return to a specific query. For example, 'GetRandomVerse?versionId=kjv&limitToBookId=nt&limitToQuery=faith' will limit the randomized return to a verse wherein the word 'faith' is found. This is a useful option for targeting specific subjects while still maintaining randomization. **Headers:** Content-Type: application/json **Parameters:** - `versionId`: String (e.g., 'kjv') - `limitToBookId`: Integer - `limitToChapterId`: Integer - `limitToQuery`: String (e.g., 'faith') *Example request:* `GetRandomVerse?versionId=kjv&limitToBookId=20&limitToChapterId=1` *Example response:* `[{"id":"20001015","b":"20","c":"1","v":"15","t":"My son, walk not thou in the way with them; refrain thy foot from their path:"}]`

### GetReadingTimeByAge **Description:** This response contains information about how long, on average (with a range of 'high', 'average', and 'low'), it should take a reader of the specified age ('requestedAge') to read the number of words in the 'wordCount' parameter value. Both 'requestedAge' and 'wordCount' are required parameters. The response is divided into 'silent' and 'oral' (silent reading is the process of reading without speaking the words, while 'oral' reading is the converse (i.e., reading aloud)). Each division of the response is further sub-divided into 'high', 'average', and 'low' ranges ('high' is a fast reader, whereas 'low' is a slow reader); each containing the amount of time the reader, by the age set in the 'requestedAge' parameter, should be able to read the number of words in 'seconds', 'minutes', 'hours', and 'days'. This endpoint complements the 'GetBibleReadingPlan' endpoint by ascertaining more precise average values for the time in reading chapters (q.v.), but can also be easily coupled with the 'GetWordCountOfVerse', 'GetWordCountOfChapter'. and 'GetWordCountOfBook' endpoints to enable your app to display estimated reading times for your users when formulating reading plans or schedules in diverse feature-sets. Although not represented in the resulting JSON of this endpoint, the calculations for ages above 18 - 25 are formulated internally with the data obtained from research. Interestingly, as we humans sail past the age of 25, on average, our reading speeds begin to decline - whereas there had been a steady increase from the default reading age of 6 until the age range of 18 - 25. This decline is formulated thusly: 26 - 30 years of age = -20% decline 26 - 30 years of age = -50% decline 46 - 60 years of age = -57.89% decline 60+ years of age = -66.66% decline References: - https://onlinelibrary.wiley.com/doi/abs/10.1002/pits.10152 - https://wordsrated.com/reading-speed-by-age/ - https://irisreading.com/average-reading-speed-by-age-are-you-fast-enough/ - https://scholarwithin.com/average-reading-speed Also, see the following endpoints: GetBibleReadingPlan GetWordCountOfVerse GetWordCountOfChapter GetWordCountOfBook **Headers:** Content-Type: application/json **Parameters:** - `requestedAge`: Integer - `wordCount`: Integer *Example request:* `GetReadingTimeByAge?requestedAge=29&wordCount=650` *Example response:* `{"readersAge":"29","readersAgeRequested":"29","wordCount":"650","wordsPerMinuteReadingSpeed":{"low":176,"average":228,"high":280},"timeToRead":{"silent":{"low":{"seconds":221.4,"minutes":3.69,"hours":0.06,"days":0},"average":{"seconds":171, ...}`

### GetSearch **Description:** Will return all the results of the query entered. For example, 'GetSearch?query=Jesus&versionId=kjv ' will return all the results of the Bible wherein 'Jesus' is found. This is a basic search request, for advanced search needs, see 'GetSearchAdvanced'. **Headers:** Content-Type: application/json **Parameters:** - `query`: String (e.g., 'jesus') - `versionId`: String (e.g., 'kjv') *Example request:* `GetSearch?query=jesus&versionId=kjv` *Example response:* `[{"id":"40001001","b":"40","c":"1","v":"1","t":"The book of the generation of Jesus Christ, the son of David, the son of Abraham."},{"id":"40001016","b":"40","c":"1","v":"16","t":"And Jacob begat Joseph the husband of Mary, of whom was born Jesus, ... }]`

### GetSearchAdvanced **Description:** Advanced Search is a more powerful search than the 'GetSearch' GET request. For example, 'GetSearchAdvanced?query=David&versionId=kjv&matchType=exact&excludeString=urias&limitToBookId=40&limitToChapterId=1' will search for 'David' in the KJV and exclude any mention of 'Urias' within the book of Matthew ('limitToBookId=40') and within chapter one (1) ('limitToChapterId=1') only. When using the 'limitToBookId' parameter, you can also specify 'ot' or 'nt' instead of the numeric 'bookId' to limit the search to the Old or New Testament. Note that nothing should follow the 'limitToBookId' when using 'ot' or 'nt' values. The 'matchType' parameter can be set to 'broad' or 'exact'. A broad setting will include any general matches, for example, 'GetSearchAdvanced?query=da&versionId=kjv&matchType=broad' will return all instances wherein the string, 'da', is found. So, a verse containing, 'darkness' would be considered correct. However, if we limit the search to exact with the 'matchType' parameter, only an exact match would return. For example, 'GetSearchAdvanced?query=da&versionId=kjv&matchType=exact' would return empty as the word 'da' does not exist. Note: Queries must be a minimum of two (2) characters. **Headers:** Content-Type: application/json **Parameters:** - `query`: String - `versionId`: String (e.g., 'kjv') - `matchType`: String (e.g., 'exact') - `excludeString`: String - `limitToBookId`: Integer - `limitToChapterId`: Integer *Example request:* `GetSearchAdvanced?query=David&versionId=kjv&matchType=exact&excludeString=urias&limitToBookId=40&limitToChapterId=1` *Example response:* `[{"id":"40001001","b":"40","c":"1","v":"1","t":"The book of the generation of Jesus Christ, the son of David, the son of Abraham."},{"id":"40001017","b":"40","c":"1","v":"17","t":"So all the generations from Abraham to David are fourteen generations; and from David until the carrying away into Babylon are fourteen generations; and from the carrying away into Babylon unto Christ are fourteen generations."},{"id":"40001020","b":"40","c":"1","v":"20","t":"But while he thought on these things, behold, the angel of the LORD appeared unto him in a dream, saying, Joseph, thou son of David, fear not to take unto thee Mary thy wife: for that which is conceived in her is of the Holy Ghost."}]`

### GetSearchCount **Description:** GetSearchCount will return the total results count for any search term (query) entered. For example, 'GetSearchCount?query=Jesus&versionId=kjv' will return 943 the number of times that the word, "Jesus" appears in the KJV. **Headers:** Content-Type: application/json **Parameters:** - `query`: String - `versionId`: String (e.g., 'kjv') *Example request:* `GetSearchCount?query=Messiah&versionId=kjv` *Example response:* `{"searchCount":2}`

### GetSemanticRelations - NEW! **Description:** Returns a list of words semantically related to the input word specified, based on the vocabulary found in the King James Version (KJV) of the Bible. This endpoint helps to identify synonyms or closely associated words, which can be useful in applications involving natural language processing, lexical analysis, or semantic search. The lookup is case-insensitive, meaning the word can be provided in any capitalization format. The endpoint dynamically fetches the semantic relations from the corresponding JSON file based on the first letter of the input word. **Headers:** Content-Type: application/json **Parameters:** - `word`: String (The word for which you want to retrieve semantic relations) *Example request:* `GetSemanticRelations?word=faith` *Example response:* `{"word":"Faith","related":["Belief","Trust","Conviction","Confidence","Loyalty"]}`

### GetStories **Description:** Will return a JSON containing all of the stories by their starting and ending verses of the Bible. Currently, only in English (?language=english), but more are in active development. **Headers:** Content-Type: application/json **Parameters:** - `language`: String (e.g., 'english') *Example request:* `GetStories?language=english` *Example response:* `[{"id":"1","verse_id":"1001001","story":"God Creates the World","verses_1":"Genesis 1:1","verses_2":"","verses_3":"","verses_4":""}, ... }]`

### GetStrongs **Description:** Returns Strong's in Hebrew or Greek. The [id] in the JSON returned corresponds to the 'H' for Hebrew and 'G' for Greek that Strong's uses to precede the id. Thus, an [id] of 3 in our table is equivalent to Strong's Hebrew H3 as well as Strong's Greek G3. The Strong's needed can be ascertained after using a GetOriginalText call (e.g. 'GetOriginalText?verseId=01001001') wherein we can receive back the Strong's Ids for any word in Hebrew or Greek respectively. **Headers:** Content-Type: application/json **Parameters:** - `lexiconId`: String (e.g., 'H') - `id`: Integer *Example request:* `GetStrongs?lexiconId=H&id=21` *Example response:* `[{"id":"21","strongs_id":"H21","language":"H","word":"\u05d0\u05b2\u05d1\u05b4\u05d9","glossary":"Abiy (ab-ee') n\/p.\n1. fatherly\n2. Abi, Hezekiah's mother\n[from H1]\nKJV: Abi. \nRoot(s): H1 ","occurences":"1","first_occurence":"12018002","root":"\u05d0\u05d1", ... }]`

### GetTopic **Description:** This endpoint will return JSON containing all of the citations (e.g., 1 Corinthians 13:4-8) as well as the verseIds (if more than one, they will be arrayed) that apply to the value of the topic parameter entered (e.g., 'love'). Also see: GetTopicVerseCount GetTopics **Headers:** Content-Type: application/json **Parameters:** - `topic`: String (e.g., 'love') *Example request:* `GetTopic?topic=love` *Example response:* `[{"citation":"1 Corinthians 13:4-8","verseIds":["46013004","46013005","46013006","46013007","46013008"]},{"citation":"1 Corinthians 16:14", ...}]`

### GetTopics **Description:** This endpoint will return the JSON array for all of the available topics that can be used with the 'GetTopic' endpoint, q.v. Also see: GetTopic GetTopicVerseCount **Headers:** Content-Type: application/json **Parameters:** - N/A *Example request:* `GetTopics` *Example response:* `["addiction","adultery","afterlife","alcohol","animals","anger","angels","anxiety","baptism","birth","business","charity","children", ...]`

### GetTopicVerseCount **Description:** Will return a verse count for any topic parameter value. Also see: GetTopic GetTopics **Headers:** Content-Type: application/json **Parameters:** - `topic`: String (e.g., 'angels') *Example request:* `GetTopicVerseCount?topic=love` *Example response:* `155`

### GetVerse **Description:** Will return a single verse from the Bible using the 'verseId', which is composed of eight (8) digits. The first two (2) are the book number, the second three (3) are the chapter number, and the last three (3) are the verse number. **Headers:** Content-Type: application/json **Parameters:** - `verseId`: String (e.g., '01001001') - `versionId`: String (e.g., 'kjv') *Example request:* `GetVerse?verseId=01001001&versionId=kjv` *Example response:* `[{"id":"01001001","b":"1","c":"1","v":"1","t":"In the beginning God created the heaven and the earth."}]`

### GetVerseCount - NEWLY UPDATED! **Description:** Returns the number of verses for a specified book and chapter. You can now optionally specify the Bible version to use. If no version is provided, the function defaults to the King James Version (KJV). This update allows you to account for differences in verse counts between Bible versions. For example, the 43rd chapter of Genesis contains 34 verses in the KJV, but only 33 verses in the Bible in Basic English (BBE). **Headers:** `Content-Type: application/json` **Parameters:** - `bookId`: Integer (The ID of the book) - `chapterId`: Integer (The chapter number) - `versionId` (optional): String (e.g., `"kjv"`, `"bbe"`) — Defaults to `"kjv"` if not provided. *Example Request using KJV:* `GetVerseCount?bookId=1&chapterId=43&versionId=kjv` *Example response using KJV:* `{"verseCount":34}` *Example Request using BBE:* `GetVerseCount?bookId=1&chapterId=43&versionId=bbe` *Example response using BBE:* `{"verseCount":33}`

### GetVersions **Description:** Will return an array of the bible versions available in the API. *Because Bible versions are standardized across the world, we do not attempt to translate versions programmatically.* 1. *English versions: ASV (American Standard 1901), BBE (Bible in Basic English), DBY (Darby English Bible), KJV (King James Version), KJV1611 (King James Version 1611), WBT (Webster Bible), WEB (World English Bible), YLT (Young Literal Translation)* 2. *Spanish version: RV1909 (Reina-Valera 1909)* 3. *Arabic version: SVD (Smith-Van Dyke)* **Headers:** Content-Type: application/json **Parameters:** - N/A *Example request:* `GetVersions` *Example response:* `[{"table":"t_asv","version_id":"1","abbreviation":"ASV","version":"American Standard \r\n - 1901","language":"english"},{"table":"t_bbe", ... }]`

### GetWordCountOfBook **Description:** This response will provide a count of all of the words in the book ('bookId') and version ('versionId') submitted. Both parameters are required. For example, 'GetWordCountOfBook?bookId=01&versionId=kjv' would return a complete count of all the words in the book of Genesis ('bookId=01') in the KJV version ('versionId=kjv'). Both parameters are required. **Headers:** Content-Type: application/json **Parameters:** - `bookId`: Integer or String - `versionId`: String (e.g., 'kjv') *Example request:* `GetWordCountOfBook?bookId=01&versionId=kjv` *Example response:* `{"bookId":"01","versionId":"kjv","wordCount":38265}`

### GetWordCountOfChapter **Description:** 'GetWordCountOfChapter' returns the count of all of the words in any given chapter specified by the value of the 'bookAndChapterId' in the version ('versionId') requested. For example, 'GetWordCountOfChapter?bookAndChapterId=01001&versionId=kjv' would return a complete count of all the words in the first chapter of the book of Genesis ('bookAndChapterId=01001') in the KJV version ('versionId=kjv'). Both parameters are required. **Headers:** Content-Type: application/json **Parameters:** - `bookAndChapterId`: String (e.g., '01001') - `versionId`: String (e.g., 'kjv') *Example request:* `GetWordCountOfChapter?bookAndChapterId=01001&versionId=kjv` *Example response:* `{"bookAndChapterId":"01001","versionId":"kjv","wordCount":797}`

### GetWordCountOfVerse **Description:** The response will contain a count of all of the words in any given verse specified by the value of the 'verseId' in the version requested ('versionId'). For example, 'GetWordCountOfVerse?verseId=01001001&versionId=kjv' would return a complete count of all the words in the first verse of the book of Genesis in chapter one ('verseId=01001001') of the KJV version ('versionId=kjv'). Both parameters are required. **Headers:** Content-Type: application/json **Parameters:** - `verseId`: String (e.g., '01001001') - `versionId`: String (e.g., 'kjv') *Example request:* `GetWordCountOfVerse?verseId=01001001&versionId=kjv` *Example response:* `{"verseId":"01001001","versionId":"kjv","wordCount":10}`

### GetWords **Description:** Will return a word-by-word JSON array of the specified verse, along with the word count. Also, see the following endpoints: GetWordCountOfBook GetWordCountOfChapter GetWordCountOfVerse **Headers:** Content-Type: application/json **Parameters:** - `verseId`: String (e.g., '01001001') - `versionId`: String (e.g., 'kjv') *Example request:* `GetWords?verseId=01001001&versionId=kjv` *Example response:* `{"verseId":"01001001","versionId":"kjv","wordCount":10,"0":"In","1":"the","2":"beginning","3":"God","4":"created","5":"the","6":"heaven","7":"and","8":"the","9":"earth."}`

### GetWordsOfJesus **Description:** This endpoint will return an array of all the verses ('verseIds') wherein Jesus spoke - just as you would find in a 'red letter edition' bible. This endpoint does not take any parameters. Those verses can then be called via the 'GetVerse' endpoint. **Headers:** Content-Type: application/json **Parameters:** - N/A *Example request:* `GetWordsOfJesus` *Example response:* `{"[0]":"40003015","[1]":"40004004","[2]":"40004007","[3]":"40004010","[4]":"40004017","[5]":"40004019","[6]":"40005003","[7]":"40005004", ... }`
--- ## About Us --- ### About Websitie https://websitie.com We're developers and designers with over 20 years of experience. And even though we've worked with some of the biggest brands in the world, like Yahoo, Wikipedia, and Publisher's Clearing House; we've also custom-coded and designed websites and apps for small businesses and startups using the same efficiency, power, and expertise that we use on the big brands. Big brand, small business, or start-up we've got you covered. --- ### About Jody Jody's a full stack web development and artificial intelligence consultant and software engineer with over 25 years of experience. Website: [JodyPM.com](https://jodypm.com) Contact: - Email: [jody@websitie.com](mailto:jody@websitie.com) - Book a call: [Schedule a call](https://jodypm.com/contact.php). Connect with Jody: - [LinkedIn](https://www.linkedin.com/in/jodypm/) - [X (formerly Twitter)](https://twitter.com/jodypm_dev) ---