Developer Tools: API

Application Programming Interface (API)

Books

These are the books of the Bible. Books belong to versions and to bookgroups, and books have many chapters.

List

Book listings may only be requested in the context of version or bookgroup parents.

GET /versions/#{version_id}/books.xml?include_chapters=true

Returns a list of a books for the version resource with the specified ID. The available version IDs can be listed with the versions endpoint.

Note: when the include_chapters is set to true, the response will include the list of chapters within each book.

Example:

Request
XML
JSON
GET https://bibles.org/v2/versions/eng-GNTD/books.xml
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <books>
    <book id="eng-GNTD:Gen">
      <version_id>135</version_id>
      <name>Genesis</name>
      <abbr>Gen</abbr>
      <ord>1</ord>
      <book_group_id>0</book_group_id>
      <testament>OT</testament>
      <id>eng-GNTD:Gen</id>
      <osis_end>eng-GNTD:Gen.50.26</osis_end>
      <parent>
        <version id="eng-GNTD">
          <path>/versions/eng-GNTD</path>
          <name>Good News Translation (US Version)</name>
          <id>eng-GNTD</id>
        </version>
      </parent>
      <next>
        <book id="eng-GNTD:Exod">
          <path>/books/eng-GNTD:Exod</path>
          <name>Exodus</name>
          <id>eng-GNTD:Exod</id>
        </book>
      </next>
      <copyright><![CDATA[<p>Good News Translation (Today’s English Version, Second Edition) © 1992 American Bible Society. All rights reserved.</p>]]></copyright>
    </book>
    <book id="eng-GNTD:Exod">
      <version_id>135</version_id>
      <name>Exodus</name>
      <abbr>Exod</abbr>
      <ord>2</ord>
      <book_group_id>0</book_group_id>
      <testament>OT</testament>
      <id>eng-GNTD:Exod</id>
      <osis_end>eng-GNTD:Exod.40.38</osis_end>
      <parent>
        <version id="eng-GNTD">
          <path>/versions/eng-GNTD</path>
          <name>Good News Translation (US Version)</name>
          <id>eng-GNTD</id>
        </version>
      </parent>
      <next>
        <book id="eng-GNTD:Lev">
          <path>/books/eng-GNTD:Lev</path>
          <name>Leviticus</name>
          <id>eng-GNTD:Lev</id>
        </book>
      </next>
      <previous>
        <book id="eng-GNTD:Gen">
          <path>/books/eng-GNTD:Gen</path>
          <name>Genesis</name>
          <id>eng-GNTD:Gen</id>
        </book>
      </previous>
      <copyright><![CDATA[<p>Good News Translation (Today’s English Version, Second Edition) © 1992 American Bible Society. All rights reserved.</p>]]></copyright>
    </book>
    [... Books removed for brevity ...]
  </books>
  <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('51701ba10a0fd8.80239937');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51701ba10a0fd8.80239937" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>51701ba10a0fd8.80239937</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('51701ba10a0fd8.80239937'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51701ba10a0fd8.80239937" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>

Example with chapters:

Request
XML
JSON
GET https://bibles.org/v2/versions/eng-GNTD/books.xml?include_chapters=true
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <books>
    <book id="eng-GNTD:Gen">
      <version_id>27</version_id>
      <name>Genesis</name>
      <abbr>Gen</abbr>
      <ord>1</ord>
      <book_group_id>18</book_group_id>
      <testament>OT</testament>
      <id>eng-GNTD:Gen</id>
      <osis_end>eng-GNTD:Gen.50.26</osis_end>
      <parent>
        <version id="eng-GNTD">
          <path>/versions/eng-GNTD</path>
          <name>Good News Translation (US Version)</name>
          <id>eng-GNTD</id>
        </version>
      </parent>
      <next>
        <book id="eng-GNTD:Exod">
          <path>/books/eng-GNTD:Exod</path>
          <name>Exodus</name>
          <id>eng-GNTD:Exod</id>
        </book>
      </next>
      <copyright><![CDATA[<p>Good News Translation (Today’s English Version, Second Edition) © 1992 American Bible Society. All rights reserved.</p>]]></copyright>
      <chapters>
        <chapter>
          <id>eng-GNTD:Gen.1</id>
          <osis_end>eng-GNTD:Gen.1.31</osis_end>
          <chapter>1</chapter>
        </chapter>
        [... Chapters removed for brevity ...]
        <chapter>
          <id>eng-GNTD:Gen.50</id>
          <osis_end>eng-GNTD:Gen.50.26</osis_end>
          <chapter>50</chapter>
        </chapter>
      </chapters>
    </book>
    <book id="eng-GNTD:Exod">
      <version_id>27</version_id>
      <name>Exodus</name>
      <abbr>Exod</abbr>
      <ord>2</ord>
      <book_group_id>18</book_group_id>
      <testament>OT</testament>
      <id>eng-GNTD:Exod</id>
      <osis_end>eng-GNTD:Exod.40.38</osis_end>
      <parent>
        <version id="eng-GNTD">
          <path>/versions/eng-GNTD</path>
          <name>Good News Translation (US Version)</name>
          <id>eng-GNTD</id>
        </version>
      </parent>
      <next>
        <book id="eng-GNTD:Lev">
          <path>/books/eng-GNTD:Lev</path>
          <name>Leviticus</name>
          <id>eng-GNTD:Lev</id>
        </book>
      </next>
      <previous>
        <book id="eng-GNTD:Gen">
          <path>/books/eng-GNTD:Gen</path>
          <name>Genesis</name>
          <id>eng-GNTD:Gen</id>
        </book>
      </previous>
      <copyright><![CDATA[<p>Good News Translation (Today’s English Version, Second Edition) © 1992 American Bible Society. All rights reserved.</p>]]></copyright>
      <chapters>
        <chapter>
          <id>eng-GNTD:Exod.1</id>
          <osis_end>eng-GNTD:Exod.1.22</osis_end>
          <chapter>1</chapter>
        </chapter>
        [... Chapters removed for brevity ...]
        <chapter>
          <id>eng-GNTD:Exod.40</id>
          <osis_end>eng-GNTD:Exod.40.38</osis_end>
          <chapter>40</chapter>
        </chapter>
      </chapters>
    </book>
    [... Books removed for brevity ...]
  </books>
  <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('520533986da868.01931174');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=520533986da868.01931174" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>520533986da868.01931174</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('520533986da868.01931174'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=520533986da868.01931174" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>

GET /bookgroups/#{group_id}/books.xml

Returns a list of all books for the bookgroup resource with the specified ID. The available book group IDs can be listed with the bookgroups endpoint.

Example:

Request
XML
JSON
GET https://bibles.org/v2/bookgroups/1/books.xml
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <books>
    <book id="AMP:Gen">
      <version_id>9</version_id>
      <name>Genesis</name>
      <abbr>Gen</abbr>
      <ord>1</ord>
      <book_group_id>1</book_group_id>
      <testament>OT</testament>
      <id>AMP:Gen</id>
      <osis_end>AMP:Gen.50.26</osis_end>
      <parent>
        <version id="AMP">
          <path>/versions/AMP</path>
          <name>Amplified Bible</name>
          <id>AMP</id>
        </version>
      </parent>
      <next>
        <book id="KJV:Gen">
          <path>/books/KJV:Gen</path>
          <name>Genesis</name>
          <id>KJV:Gen</id>
        </book>
      </next>
      <copyright><![CDATA[All rights reserved. For Permission To Quote information visit http://www.lockman.org/]]></copyright>
    </book>
    <book id="KJV:Gen">
      <version_id>21</version_id>
      <name>Genesis</name>
      <abbr>Gen</abbr>
      <ord>1</ord>
      <book_group_id>1</book_group_id>
      <testament>OT</testament>
      <id>KJV:Gen</id>
      <osis_end>KJV:Gen.50.26</osis_end>
      <parent>
        <version id="AMP">
          <path>/versions/AMP</path>
          <name>Amplified Bible</name>
          <id>AMP</id>
        </version>
      </parent>
      <next>
        <book id="AMP:Exod">
          <path>/books/AMP:Exod</path>
          <name>Exodus</name>
          <id>AMP:Exod</id>
        </book>
      </next>
      <previous>
        <book id="AMP:Gen">
          <path>/books/AMP:Gen</path>
          <name>Genesis</name>
          <id>AMP:Gen</id>
        </book>
      </previous>
      <copyright><![CDATA[All rights reserved. For Permission To Quote information visit http://www.lockman.org/]]></copyright>
    </book>
    [... Books removed for brevity ...]
  </books>
  <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('51701cad9b82d6.42316644');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51701cad9b82d6.42316644" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>51701cad9b82d6.42316644</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('51701cad9b82d6.42316644'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51701cad9b82d6.42316644" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>

GET /versions/#{version_id}/books.xml?testament=#{testament_abbr}

Returns a list of only those books identified by the Testament abbreviation for the version resource with the specified ID. The available version IDs can be listed with the versions endpoint. Valid testament abbreviations are NT (New Testament), OT (Old Testament) and DEUT (Deuterocanonical).

Example:

Request
XML
JSON
GET https://bibles.org/v2/versions/eng-KJVA/books.xml?testament=NT
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <books>
    <book id="eng-KJVA:Matt">
      <version_id>369</version_id>
      <name>Matthew</name>
      <abbr>Matt</abbr>
      <ord>54</ord>
      <book_group_id>0</book_group_id>
      <testament>NT</testament>
      <id>eng-KJVA:Matt</id>
      <osis_end>eng-KJVA:Matt.28.20</osis_end>
      <parent>
        <version id="eng-KJVA">
          <path>/versions/eng-KJVA</path>
          <name>King James Version with Deuterocanon, American Edition</name>
          <id>eng-KJVA</id>
        </version>
      </parent>
      <next>
        <book id="eng-KJVA:Mark">
          <path>/books/eng-KJVA:Mark</path>
          <name>Mark</name>
          <id>eng-KJVA:Mark</id>
        </book>
      </next>
      <previous>
        <book id="eng-KJVA:PrMan">
          <path>/books/eng-KJVA:PrMan</path>
          <name>Prayer of Manasseh</name>
          <id>eng-KJVA:PrMan</id>
        </book>
      </previous>
      <copyright><![CDATA[<p>King James Version 1611, spelling, punctuation and text formatting modernized by ABS in 1962; typesetting © 2010 American Bible Society.</p>]]></copyright>
    </book>
    <book id="eng-KJVA:Mark">
      <version_id>369</version_id>
      <name>Mark</name>
      <abbr>Mark</abbr>
      <ord>55</ord>
      <book_group_id>0</book_group_id>
      <testament>NT</testament>
      <id>eng-KJVA:Mark</id>
      <osis_end>eng-KJVA:Mark.16.20</osis_end>
      <parent>
        <version id="eng-KJVA">
          <path>/versions/eng-KJVA</path>
          <name>King James Version with Deuterocanon, American Edition</name>
          <id>eng-KJVA</id>
        </version>
      </parent>
      <next>
        <book id="eng-KJVA:Luke">
          <path>/books/eng-KJVA:Luke</path>
          <name>Luke</name>
          <id>eng-KJVA:Luke</id>
        </book>
      </next>
      <previous>
        <book id="eng-KJVA:Matt">
          <path>/books/eng-KJVA:Matt</path>
          <name>Matthew</name>
          <id>eng-KJVA:Matt</id>
        </book>
      </previous>
      <copyright><![CDATA[<p>King James Version 1611, spelling, punctuation and text formatting modernized by ABS in 1962; typesetting © 2010 American Bible Society.</p>]]></copyright>
    </book>
    [... Books removed for brevity ...]
  </books>
  <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('51701dc38d9538.86124225');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51701dc38d9538.86124225" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>51701dc38d9538.86124225</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('51701dc38d9538.86124225'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51701dc38d9538.86124225" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>

Show

GET /books/#{version_id}:#{book_name}.xml

Returns the specified book resource in the specified version. The available version IDs can be listed with the versions endpoint. The book name should be specified with the OSIS normative abbreviation for the book.

Example:

Request
XML
JSON
GET https://bibles.org/v2/books/eng-GNTD:Rev.xml
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <books>
    <book id="eng-GNTD:Rev">
      <version_id>135</version_id>
      <name>Revelation</name>
      <abbr>Rev</abbr>
      <ord>78</ord>
      <book_group_id>0</book_group_id>
      <testament>NT</testament>
      <id>eng-GNTD:Rev</id>
      <osis_end>eng-GNTD:Rev.22.21</osis_end>
      <parent>
        <version id="eng-GNTD">
          <path>/versions/eng-GNTD</path>
          <name>Good News Translation (US Version)</name>
          <id>eng-GNTD</id>
        </version>
      </parent>
      <previous>
        <book id="eng-GNTD:Jude">
          <path>/books/eng-GNTD:Jude</path>
          <name>Jude</name>
          <id>eng-GNTD:Jude</id>
        </book>
      </previous>
      <copyright><![CDATA[<p>Good News Translation (Today’s English Version, Second Edition) © 1992 American Bible Society. All rights reserved.</p>]]></copyright>
    </book>
  </books>
  <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('51701eb69abd32.70167462');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51701eb69abd32.70167462" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>51701eb69abd32.70167462</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('51701eb69abd32.70167462'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51701eb69abd32.70167462" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>