Developer Tools: API

This documentation describes version 1 of the API, which is deprecated. You probably want version 2 instead. If you're still using version 1, you must migrate before July 1, 2013.

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

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.

Example:

Request
XML
JSON
GET https://bibles.org/versions/GNT/books.xml
Response
<?xml version="1.0" encoding="utf-8"?>
        <books>
          <book id="GNT:Gen">
            <version_id>1</version_id>
            <name>Genesis</name>
            <abbr>Gen</abbr>
            <ord>1</ord>
            <book_group_id>1</book_group_id>
            <testament>OT</testament>
            <id>GNT:Gen</id>
            <osis_end>GNT:Gen.50.26</osis_end>
            <parent>
              <version id="GNT">
                <path>/versions/GNT</path>
                <name>Good News Translation</name>
                <id>GNT</id>
              </version>
            </parent>
            <next>
              <book id="GNT:Exod">
                <path>/books/GNT:Exod</path>
                <name>Exodus</name>
                <id>GNT:Exod</id>
              </book>
            </next>
            <copyright><![CDATA[Scripture taken from the Good News Translation in Today's English Version- Second Edition Copyright © 1992 by American Bible Society. Used by Permission.]]></copyright>
          </book>
          <book id="GNT:Exod">
            <version_id>1</version_id>
            <name>Exodus</name>
            <abbr>Exod</abbr>
            <ord>2</ord>
            <book_group_id>1</book_group_id>
            <testament>OT</testament>
            <id>GNT:Exod</id>
            <osis_end>GNT:Exod.40.38</osis_end>
            <parent>
              <version id="GNT">
                <path>/versions/GNT</path>
                <name>Good News Translation</name>
                <id>GNT</id>
              </version>
            </parent>
            <next>
              <book id="GNT:Lev">
                <path>/books/GNT:Lev</path>
                <name>Leviticus</name>
                <id>GNT:Lev</id>
              </book>
            </next>
            <previous>
              <book id="GNT:Gen">
                <path>/books/GNT:Gen</path>
                <name>Genesis</name>
                <id>GNT:Gen</id>
              </book>
            </previous>
            <copyright><![CDATA[Scripture taken from the Good News Translation in Today's English Version- Second Edition Copyright © 1992 by American Bible Society. Used by Permission.]]></copyright>
          </book>
          [... Books removed for brevity ...]
          <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('504fa50c9f2d21.11070312');\x3C/script\x3E");
        </script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=504fa50c9f2d21.11070312" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
            <fums_tid>504fa50c9f2d21.11070312</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('504fa50c9f2d21.11070312'); }]]></fums_js>
            <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=504fa50c9f2d21.11070312" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
          </meta>
        </books>

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/bookgroups/1/books.xml
Response
<?xml version="1.0" encoding="utf-8"?>
        <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="AMP:Exod">
                <path>/books/AMP:Exod</path>
                <name>Exodus</name>
                <id>AMP:Exod</id>
              </book>
            </next>
            <copyright><![CDATA[All rights reserved. For Permission To Quote information visit http://www.lockman.org/]]></copyright>
          </book>
          <book id="ESV:Gen">
            <version_id>10</version_id>
            <name>Genesis</name>
            <abbr>Gen</abbr>
            <ord>1</ord>
            <book_group_id>1</book_group_id>
            <testament>OT</testament>
            <id>ESV:Gen</id>
            <osis_end>ESV:Gen.50.26</osis_end>
            <parent>
              <version id="ESV">
                <path>/versions/ESV</path>
                <name>English Standard Version</name>
                <id>ESV</id>
              </version>
            </parent>
            <next>
              <book id="ESV:Exod">
                <path>/books/ESV:Exod</path>
                <name>Exodus</name>
                <id>ESV:Exod</id>
              </book>
            </next>
            <copyright><![CDATA[Scripture quotations marked (ESV) are from The Holy Bible, English Standard Version®, copyright © 2001 by Crossway Bibles, a publishing ministry of Good News Publishers. Used by permission. All rights reserved.]]></copyright>
          </book>
          <book id="CEV:Gen">
            <version_id>3</version_id>
            <name>Genesis</name>
            <abbr>Gen</abbr>
            <ord>1</ord>
            <book_group_id>1</book_group_id>
            <testament>OT</testament>
            <id>CEV:Gen</id>
            <osis_end>CEV:Gen.50.26</osis_end>
            <parent>
              <version id="CEV">
                <path>/versions/CEV</path>
                <name>Contemporary English Version</name>
                <id>CEV</id>
              </version>
            </parent>
            <next>
              <book id="CEV:Exod">
                <path>/books/CEV:Exod</path>
                <name>Exodus</name>
                <id>CEV:Exod</id>
              </book>
            </next>
            <copyright><![CDATA[Copyright 2006, American Bible Society]]></copyright>
          </book>
          [... Books removed for brevity ...]
          <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('504fa6a81891c8.88475157');\x3C/script\x3E");
        </script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=504fa6a81891c8.88475157" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
            <fums_tid>504fa6a81891c8.88475157</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('504fa6a81891c8.88475157'); }]]></fums_js>
            <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=504fa6a81891c8.88475157" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
          </meta>
        </books>

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/versions/KJV/books.xml?testament=NT
Response
<?xml version="1.0" encoding="utf-8"?>
        <books>
          <book id="KJV:Matt">
            <version_id>21</version_id>
            <name>Matthew</name>
            <abbr>Matt</abbr>
            <ord>40</ord>
            <book_group_id>6</book_group_id>
            <testament>NT</testament>
            <id>KJV:Matt</id>
            <osis_end>KJV:Matt.28.20</osis_end>
            <parent>
              <version id="KJV">
                <path>/versions/KJV</path>
                <name>King James Version, British 1769 Edition</name>
                <id>KJV</id>
              </version>
            </parent>
            <next>
              <book id="KJV:Mark">
                <path>/books/KJV:Mark</path>
                <name>Mark</name>
                <id>KJV:Mark</id>
              </book>
            </next>
            <previous>
              <book id="KJV:Mal">
                <path>/books/KJV:Mal</path>
                <name>Malachi</name>
                <id>KJV:Mal</id>
              </book>
            </previous>
            <copyright><![CDATA[King James Version 1611 (Authorized Version). Copyright status: UK English with BFBS additions © 2011 British and Foreign Bible Society; Crown Copyright in UK]]></copyright>
          </book>
          <book id="KJV:Mark">
            <version_id>21</version_id>
            <name>Mark</name>
            <abbr>Mark</abbr>
            <ord>41</ord>
            <book_group_id>6</book_group_id>
            <testament>NT</testament>
            <id>KJV:Mark</id>
            <osis_end>KJV:Mark.16.20</osis_end>
            <parent>
              <version id="KJV">
                <path>/versions/KJV</path>
                <name>King James Version, British 1769 Edition</name>
                <id>KJV</id>
              </version>
            </parent>
            <next>
              <book id="KJV:Luke">
                <path>/books/KJV:Luke</path>
                <name>Luke</name>
                <id>KJV:Luke</id>
              </book>
            </next>
            <previous>
              <book id="KJV:Matt">
                <path>/books/KJV:Matt</path>
                <name>Matthew</name>
                <id>KJV:Matt</id>
              </book>
            </previous>
            <copyright><![CDATA[King James Version 1611 (Authorized Version). Copyright status: UK English with BFBS additions © 2011 British and Foreign Bible Society; Crown Copyright in UK]]></copyright>
          </book>
          <book id="KJV:Luke">
            <version_id>21</version_id>
            <name>Luke</name>
            <abbr>Luke</abbr>
            <ord>42</ord>
            <book_group_id>6</book_group_id>
            <testament>NT</testament>
            <id>KJV:Luke</id>
            <osis_end>KJV:Luke.24.53</osis_end>
            <parent>
              <version id="KJV">
                <path>/versions/KJV</path>
                <name>King James Version, British 1769 Edition</name>
                <id>KJV</id>
              </version>
            </parent>
            <next>
              <book id="KJV:John">
                <path>/books/KJV:John</path>
                <name>John</name>
                <id>KJV:John</id>
              </book>
            </next>
            <previous>
              <book id="KJV:Mark">
                <path>/books/KJV:Mark</path>
                <name>Mark</name>
                <id>KJV:Mark</id>
              </book>
            </previous>
            <copyright><![CDATA[King James Version 1611 (Authorized Version). Copyright status: UK English with BFBS additions © 2011 British and Foreign Bible Society; Crown Copyright in UK]]></copyright>
          </book>
          [... Books removed for brevity ...]
          <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('504fc877843b12.19726006');\x3C/script\x3E");
        </script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=504fc877843b12.19726006" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
            <fums_tid>504fc877843b12.19726006</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('504fc877843b12.19726006'); }]]></fums_js>
            <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=504fc877843b12.19726006" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
          </meta>
        </books>

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/books/GNT:Rev.xml
Response
<?xml version="1.0" encoding="utf-8"?>
        <books>
          <book id="GNT:Rev">
            <version_id>1</version_id>
            <name>Revelation</name>
            <abbr>Rev</abbr>
            <ord>66</ord>
            <book_group_id>8</book_group_id>
            <testament>NT</testament>
            <id>GNT:Rev</id>
            <osis_end>GNT:Rev.22.21</osis_end>
            <parent>
              <version id="GNT">
                <path>/versions/GNT</path>
                <name>Good News Translation</name>
                <id>GNT</id>
              </version>
            </parent>
            <next>
              <book id="GNT:Tob">
                <path>/books/GNT:Tob</path>
                <name>Tobit</name>
                <id>GNT:Tob</id>
              </book>
            </next>
            <previous>
              <book id="GNT:Jude">
                <path>/books/GNT:Jude</path>
                <name>Jude</name>
                <id>GNT:Jude</id>
              </book>
            </previous>
            <copyright><![CDATA[Scripture taken from the Good News Translation in Today's English Version- Second Edition Copyright © 1992 by American Bible Society. Used by Permission.]]></copyright>
          </book>
          <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('504fca1e3e6ae2.45715524');\x3C/script\x3E");
        </script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=504fca1e3e6ae2.45715524" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
            <fums_tid>504fca1e3e6ae2.45715524</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('504fca1e3e6ae2.45715524'); }]]></fums_js>
            <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=504fca1e3e6ae2.45715524" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
          </meta>
        </books>