Welcome to the IQ Bible API, which has been built to enable developers to access a well-maintained and powerful Bible API with useful out-of-the-box tools and resources, like Strong’s Concordance and the original texts in Hebrew or Greek; as well as advanced tools, like professional audio narration for complete chapters.

This API is available as a Freemium. Anyone can write their own application, program, or website to present Bible data in new and exciting ways. The API allows you to call methods that will respond with REST-style JSON.

The IQ Bible API provides an advanced structure for procuring not only Biblical passages but data from other theological sources:

• Audio Narrations (complete audio narration for any chapter)
• Multiple versions (with more in development)
• English, Spanish, and Arabic languages (with more in development)
• Cross-references
• Original Hebrew and Greek text
• Strong’s Concordance
• Parallel Bibles
• Random verse or chapter
• Stories of the Bible
• Search

IQ Bible API Documentation (v1.22.4-RC | Jan. 25, 2023)

---

Welcome

Welcome to the IQ Bible API, which has been built so that you can develop a full-featured Bible application for your own users, company, organization, or church. The IQ Bible API is replete with a wide range of diverse endpoints, such as:

• Scripture in multiple versions (with more in development)
• Audio Narrations (complete audio narration for any chapter) supporting the KJV, RV1909 (Reina Valera (1909)) (Spanish), and the Smith-Van Dyke (SVD) (Arabic) versions.
• English, Spanish, and Arabic languages (with more in development)
• Cross-references
• The original Hebrew and Greek text for any verse
• Strong’s Concordance
• Parallel Bibles
• Random verses or chapters
• Stories of the Bible
• Bible reading plan generation
• Advanced search
• And more…

Get Requests

GetAudioNarration - NEWLY UPDATED!

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,
chapterId,
versionId

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 - NEW!

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,
requestedStartDate (optional),
sections (optional),
requestedAge (optional)

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, ...

GetBookAndChapterNameByBookAndChapterId - NEWLY UPDATED!

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,
language

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

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,
language

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

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

Example request:
GetBooksOT?language=english

Example response:
[{"b":"1","n":"Genesis","t":"OT","g":"1"},{"b":"2","n":"Exodus","t":"OT","g":"1"}, ... }]

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,
language

Example request:
GetBookNameByBookId?bookId=01&language=english

Example response:
[{“n”:“Genesis”}]

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,
language

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,
language

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,
chapterId,
versionId

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."}, ... }]

GetChapterByBookAndChapterId - NEW!

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,
versionId

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

Example request:
GetChapterCount?bookId=66

Example response:
{"chapterCount":22}

GetChronological

Description:
Returns an array containing a general list of the chronological events of the Bible.

Headers:
Content-Type: application/json

Parameters:
language

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’. Bot parameters are required.

Headers:
Content-Type: application/json

Parameters:
verseId,
commentaryName

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

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,
dictionaryId

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 ... "}

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

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

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

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 - NEW!

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

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

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

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 - NEW!

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

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

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

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 - NEWLY UPDATED!

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,
limitToBookId (optional),
limitToChapterId (optional),
limitToQuery (optional)

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 - NEW!

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,
wordCount

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,
versionId

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 - NEW!

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,
versionId,
matchType (optional),
excludeString (optional),
limitToBookId (optional),
limitToChapterId (optional)

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,
versionId

Example request:
GetSearchCount?query=Messiah&versionId=kjv

Example response:
{"searchCount":2}

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

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

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", ... }]

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,
versionId

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

Description:
Returns the number of verses for the specified book and chapter. In the example, we want to know how many verses are in the 2nd chapter of Genesis.

Headers:
Content-Type: application/json

Parameters:
bookId,
chapterId

Example request:
GetVerseCount?bookId=1&chapterId=2

Example response:
{"verseCount":25}

GetVersions - NEWLY UPDATED!

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 - NEW!

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,
versionId,

Example request:
GetWordCountOfBook?bookId=01&versionId=kjv

Example response:
{"bookId":"01","versionId":"kjv","wordCount":38265}

GetWordCountOfChapter - NEW!

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,
versionId

Example request:
GetWordCountOfChapter?bookAndChapterId=01001&versionId=kjv

Example response:
{"bookAndChapterId":"01001","versionId":"kjv","wordCount":797}

GetWordCountOfVerse - NEW!

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,
versionId

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,
versionId

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", ... }