Developer Tools: API

Application Programming Interface (API)

Passages

GET /passages.xml?q[]=#{passage_specifier_list}

GET /passages.xml?q[]=#{passage_specifier_list}&version=#{version_id_list}

GET /passages.xml?q[]=#{passage_specifier_list}&version=#{version_id_list}&include_marginalia=true

Returns a structured response containing a collection of references to passages specified by the q[] querystring parameter. One or more Bible versions may be specified by the version parameter. Misspelled book names or abbreviations will be corrected if possible. When include_marginalia is set to true, the response will include footnotes and crossreferences and the Bible text will include marginalia markers.

The passage specifier is in the form "Book+chapters:verses". Multiple specifiers can be included in a comma-separated list. Examples: "John+3", "John+3-5", "John+3:12", "John+3:12-15", "John+3,Luke+2".

The available version IDs can be listed with the versions endpoint. Multiple version IDs can be included in a comma-separated list. Examples: "KJV", "GNT,CEV".

Single passage, single version example:

Request
XML
JSON
GET https://ga.bibles.org/v2/passages.xml?q[]=john+3:1-5&version=eng-KJVA
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <search>
    <result>
      <type>passages</type>
      <passages>
        <passage>
          <display>John 3:1-5</display>
          <version>eng-KJVA</version>
          <version_abbreviation>KJVA</version_abbreviation>
          <path>/chapters/eng-KJVA:John.3/verses.xml?start=1&end=5</path>
          <start_verse_id>eng-KJVA:John.3.1</start_verse_id>
          <end_verse_id>eng-KJVA:John.3.5</end_verse_id>
          <text><![CDATA[<h3 class="s1">Jesus and Nicodemus</h3>
<p class="p"><sup id="John.3.1" class="v">1</sup>There was a man of the Pharisees, named Nicode´mus, a ruler of the Jews:<sup id="John.3.2" class="v">2</sup>the same came to Jesus by night, and said unto him, Rabbi, we know that thou art a teacher come from God: for no man can do these miracles that thou doest, except God be with him.<sup id="John.3.3" class="v">3</sup>Jesus answered and said unto him, Verily, verily, I say unto thee, Except a man be born again, he cannot see the kingdom of God.<sup id="John.3.4" class="v">4</sup>Nicode´mus saith unto him, How can a man be born when he is old? can he enter the second time into his mother's womb, and be born?<sup id="John.3.5" class="v">5</sup>Jesus answered, Verily, verily, I say unto thee, Except a man be born of water and <span class="add">of</span> the Spirit, he cannot enter into the kingdom of God.</p>]]></text>
          <copyright><p>King James Version 1611, spelling, punctuation and text formatting modernized by ABS in 1962; typesetting © 2010 American Bible Society.</p></copyright>
        </passage>
      </passages>
    </result>
  </search>
  <meta>
    <fums><![CDATA[<script>
var _BAPI=_BAPI||{};
if(typeof(_BAPI.t)==='undefined'){
document.write('\x3Cscript src="'+document.location.protocol+'//d2ue49q0mum86x.cloudfront.net/include/fums.c.js"\x3E\x3C/script\x3E');}
document.write("\x3Cscript\x3E_BAPI.t('51704541deb581.33215313');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51704541deb581.33215313" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>51704541deb581.33215313</fums_tid>
    <fums_js_include>d2ue49q0mum86x.cloudfront.net/include/fums.c.js</fums_js_include>
    <fums_js><![CDATA[var _BAPI=_BAPI||{};if(typeof(_BAPI.t)!='undefined'){ _BAPI.t('51704541deb581.33215313'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51704541deb581.33215313" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>

Single passage with marginalia, single version example:

Request
XML
JSON
GET https://ga.bibles.org/v2/passages.xml?q[]=john+3:1-5&version=eng-KJVA&include_marginalia=true
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <search>
    <result>
      <type>passages</type>
      <passages>
        <passage>
          <display>John 3:1-5</display>
          <version>eng-KJVA</version>
          <version_abbreviation>KJVA</version_abbreviation>
          <path>/chapters/eng-KJVA:John.3/verses.xml?start=1&end=5</path>
          <start_verse_id>eng-KJVA:John.3.1</start_verse_id>
          <end_verse_id>eng-KJVA:John.3.5</end_verse_id>
          <text><![CDATA[<h3 class="s1">Jesus and Nicodemus</h3>
<p class="p"><sup id="John.3.1" class="v">1</sup>There was a man of the Pharisees, named Nicode´mus, a ruler of the Jews:<sup id="John.3.2" class="v">2</sup>the same came to Jesus by night, and said unto him, Rabbi, we know that thou art a teacher come from God: for no man can do these miracles that thou doest, except God be with him.<sup id="John.3.3" class="v">3</sup>Jesus answered and said unto him, Verily, verily, I say unto thee, Except a man be born again,<a href="#John.3.3!f.1" id="link_John.3.3!f.1" class="notelink">+</a> he cannot see the kingdom of God.<sup id="John.3.4" class="v">4</sup>Nicode´mus saith unto him, How can a man be born when he is old? can he enter the second time into his mother's womb, and be born?<sup id="John.3.5" class="v">5</sup>Jesus answered, Verily, verily, I say unto thee, Except a man be born of water and <span class="add">of</span> the Spirit, he cannot enter into the kingdom of God.</p>]]></text>
          <copyright><p>King James Version 1611, spelling, punctuation and text formatting modernized by ABS in 1962; typesetting © 2010 American Bible Society.</p></copyright>
          <footnotes>
            <footnote>
              <marker>+</marker>
              <content><![CDATA[<span verse_id="John.3.3" id="John.3.3!f.1" class="note f"><span class="fr">3.3,7 </span><span class="fq">again </span><span class="ft">or </span><span class="fqa">from above.</span></span>]]></content>
              <note_id>John.3.3!f.1</note_id>
              <verse_id>eng-KJVA:John.3.3</verse_id>
            </footnote>
          </footnotes>
          <crossreferences/>
        </passage>
      </passages>
    </result>
  </search>
  <meta>
    <fums><![CDATA[<script>
var _BAPI=_BAPI||{};
if(typeof(_BAPI.t)==='undefined'){
document.write('\x3Cscript src="'+document.location.protocol+'//d2ue49q0mum86x.cloudfront.net/include/fums.c.js"\x3E\x3C/script\x3E');}
document.write("\x3Cscript\x3E_BAPI.t('51d33592a494c7.93559842');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51d33592a494c7.93559842" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>51d33592a494c7.93559842</fums_tid>
    <fums_js_include>d2ue49q0mum86x.cloudfront.net/include/fums.c.js</fums_js_include>
    <fums_js><![CDATA[var _BAPI=_BAPI||{};if(typeof(_BAPI.t)!='undefined'){ _BAPI.t('51d33592a494c7.93559842'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51d33592a494c7.93559842" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>

Single passage, multiple versions example:

Request
XML
JSON
GET https://ga.bibles.org/v2/passages.xml?q[]=john+3:1-5&version=eng-KJVA,eng-GNTD
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <search>
    <result>
      <type>passages</type>
      <passages>
        <passage>
          <display>John 3:1-5</display>
          <version>eng-KJVA</version>
          <version_abbreviation>KJVA</version_abbreviation>
          <path>/chapters/eng-KJVA:John.3/verses.xml?start=1&end=5</path>
          <start_verse_id>eng-KJVA:John.3.1</start_verse_id>
          <end_verse_id>eng-KJVA:John.3.5</end_verse_id>
          <text><![CDATA[<h3 class="s1">Jesus and Nicodemus</h3>
<p class="p"><sup id="John.3.1" class="v">1</sup>There was a man of the Pharisees, named Nicode´mus, a ruler of the Jews:<sup id="John.3.2" class="v">2</sup>the same came to Jesus by night, and said unto him, Rabbi, we know that thou art a teacher come from God: for no man can do these miracles that thou doest, except God be with him.<sup id="John.3.3" class="v">3</sup>Jesus answered and said unto him, Verily, verily, I say unto thee, Except a man be born again, he cannot see the kingdom of God.<sup id="John.3.4" class="v">4</sup>Nicode´mus saith unto him, How can a man be born when he is old? can he enter the second time into his mother's womb, and be born?<sup id="John.3.5" class="v">5</sup>Jesus answered, Verily, verily, I say unto thee, Except a man be born of water and <span class="add">of</span> the Spirit, he cannot enter into the kingdom of God.</p>]]></text>
          <copyright><p>King James Version 1611, spelling, punctuation and text formatting modernized by ABS in 1962; typesetting © 2010 American Bible Society.</p></copyright>
        </passage>
        <passage>
          <display>John 3:1-5</display>
          <version>eng-GNTD</version>
          <version_abbreviation>GNTD</version_abbreviation>
          <path>/chapters/eng-GNTD:John.3/verses.xml?start=1&end=5</path>
          <start_verse_id>eng-GNTD:John.3.1</start_verse_id>
          <end_verse_id>eng-GNTD:John.3.5</end_verse_id>
          <text><![CDATA[<h3 class="s">Jesus and Nicodemus</h3>
<p class="p"><sup id="John.3.1" class="v">1</sup>There was a Jewish leader named Nicodemus, who belonged to the party of the Pharisees.<sup id="John.3.2" class="v">2</sup>One night he went to Jesus and said to him, “Rabbi, we know that you are a teacher sent by God. No one could perform the miracles you are doing unless God were with him.”</p><p class="p"><sup id="John.3.3" class="v">3</sup>Jesus answered, “I am telling you the truth: no one can see the Kingdom of God without being born again.” </p><p class="p"><sup id="John.3.4" class="v">4</sup>“How can a grown man be born again?” Nicodemus asked. “He certainly cannot enter his mother's womb and be born a second time!”</p><p class="p"><sup id="John.3.5" class="v">5</sup>“I am telling you the truth,” replied Jesus, “that no one can enter the Kingdom of God without being born of water and the Spirit.</p>]]></text>
          <copyright><p>Good News Translation (Today&#8217;s English Version, Second Edition) &#169; 1992 American Bible Society. All rights reserved.</p></copyright>
        </passage>
      </passages>
    </result>
  </search>
  <meta>
    <fums><![CDATA[<script>
var _BAPI=_BAPI||{};
if(typeof(_BAPI.t)==='undefined'){
document.write('\x3Cscript src="'+document.location.protocol+'//d2ue49q0mum86x.cloudfront.net/include/fums.c.js"\x3E\x3C/script\x3E');}
document.write("\x3Cscript\x3E_BAPI.t('517048b3eaa524.06234208');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=517048b3eaa524.06234208" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>517048b3eaa524.06234208</fums_tid>
    <fums_js_include>d2ue49q0mum86x.cloudfront.net/include/fums.c.js</fums_js_include>
    <fums_js><![CDATA[var _BAPI=_BAPI||{};if(typeof(_BAPI.t)!='undefined'){ _BAPI.t('517048b3eaa524.06234208'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=517048b3eaa524.06234208" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>

Note that multiple versions are specified as a comma-separated list of version abbreviations.

If you aren't sure how many verses a chapter has, you can pass in the special '-ff' keyword as the end verse to a passage search. The response will fill in the final verse for you in the display, end_verse and path elements.

Example:

Request
XML
JSON
GET https://ga.bibles.org/v2/passages.xml?q[]=john+3:16-ff&version=eng-GNTD
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <search>
    <result>
      <type>passages</type>
      <passages>
        <passage>
          <display>John 3:16-36</display>
          <version>eng-GNTD</version>
          <version_abbreviation>GNTD</version_abbreviation>
          <path>/chapters/eng-GNTD:John.3/verses.xml?start=16&end=36</path>
          <start_verse_id>eng-GNTD:John.3.16</start_verse_id>
          <end_verse_id>eng-GNTD:John.3.36</end_verse_id>
          <text><![CDATA[<p class="p"><sup id="John.3.16" class="v">16</sup>For God loved the world so much that he gave his only Son, so that everyone who believes in him may not die but have eternal life.<sup id="John.3.17" class="v">17</sup>For God did not send his Son into the world to be its judge, but to be its savior.</p><p class="p"><sup id="John.3.18" class="v">18</sup>Those who believe in the Son are not judged; but those who do not believe have already been judged, because they have not believed in God's only Son.<sup id="John.3.19" class="v">19</sup>This is how the judgment works: the light has come into the world, but people love the darkness rather than the light, because their deeds are evil.<sup id="John.3.20" class="v">20</sup>Those who do evil things hate the light and will not come to the light, because they do not want their evil deeds to be shown up.<sup id="John.3.21" class="v">21</sup>But those who do what is true come to the light in order that the light may show that what they did was in obedience to God.</p><h3 class="s">Jesus and John</h3>
<p class="p"><sup id="John.3.22" class="v">22</sup>After this, Jesus and his disciples went to the province of Judea, where he spent some time with them and baptized.<sup id="John.3.23" class="v">23</sup>John also was baptizing in Aenon, not far from Salim, because there was plenty of water in that place. People were going to him, and he was baptizing them. (<sup id="John.3.24" class="v">24</sup> This was before John had been put in prison.)</p><p class="p"><sup id="John.3.25" class="v">25</sup>Some of John's disciples began arguing with a Jew  about the matter of ritual washing.<sup id="John.3.26" class="v">26</sup>So they went to John and told him, “Teacher, you remember the man who was with you on the east side of the Jordan, the one you spoke about? Well, he is baptizing now, and everyone is going to him!”</p><p class="p"><sup id="John.3.27" class="v">27</sup>John answered, “No one can have anything unless God gives it.<sup id="John.3.28" class="v">28</sup> You yourselves are my witnesses that I said, ‘I am not the Messiah, but I have been sent ahead of him.’<sup id="John.3.29" class="v">29</sup>The bridegroom is the one to whom the bride belongs; but the bridegroom's friend, who stands by and listens, is glad when he hears the bridegroom's voice. This is how my own happiness is made complete.<sup id="John.3.30" class="v">30</sup>He must become more important while I become less important.”</p><h3 class="s">He Who Comes from Heaven</h3>
<p class="p"><sup id="John.3.31" class="v">31</sup>He who comes from above is greater than all. He who is from the earth belongs to the earth and speaks about earthly matters, but he who comes from heaven is above all.<sup id="John.3.32" class="v">32</sup>He tells what he has seen and heard, yet no one accepts his message.<sup id="John.3.33" class="v">33</sup>But whoever accepts his message confirms by this that God is truthful.<sup id="John.3.34" class="v">34</sup>The one whom God has sent speaks God's words, because God gives him the fullness of his Spirit.<sup id="John.3.35" class="v">35</sup> The Father loves his Son and has put everything in his power.<sup id="John.3.36" class="v">36</sup>Whoever believes in the Son has eternal life; whoever disobeys the Son will not have life, but will remain under God's punishment.</p>]]></text>
          <copyright><p>Good News Translation (Today&#8217;s English Version, Second Edition) &#169; 1992 American Bible Society. All rights reserved.</p></copyright>
        </passage>
      </passages>
    </result>
  </search>
  <meta>
    <fums><![CDATA[<script>
var _BAPI=_BAPI||{};
if(typeof(_BAPI.t)==='undefined'){
document.write('\x3Cscript src="'+document.location.protocol+'//d2ue49q0mum86x.cloudfront.net/include/fums.c.js"\x3E\x3C/script\x3E');}
document.write("\x3Cscript\x3E_BAPI.t('5170491b0b3780.35410468');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=5170491b0b3780.35410468" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>5170491b0b3780.35410468</fums_tid>
    <fums_js_include>d2ue49q0mum86x.cloudfront.net/include/fums.c.js</fums_js_include>
    <fums_js><![CDATA[var _BAPI=_BAPI||{};if(typeof(_BAPI.t)!='undefined'){ _BAPI.t('5170491b0b3780.35410468'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=5170491b0b3780.35410468" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>