Developer Tools: API

Application Programming Interface (API)

Book Groups

By convention, books of the Bible are often organized into groups, such as the Pentateuch or Gospels. Which books belong in a grouping can vary for different versions of the Bible, and may contain a different sequence than appear in a complete book list. Book groups have many books.

List

Get /bookgroups.xml

Example:

Request
XML
JSON
GET https://bibles.org/v2/bookgroups.xml
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <bookgroups>
    <bookgroup id="1">
      <id>1</id>
      <name>Pentateuch</name>
      <ord>1</ord>
      <abbr>PENT</abbr>
    </bookgroup>
    <bookgroup id="2">
      <id>2</id>
      <name>History</name>
      <ord>2</ord>
      <abbr>HIST</abbr>
    </bookgroup>
    <bookgroup id="3">
      <id>3</id>
      <name>Wisdom</name>
      <ord>3</ord>
      <abbr>WISD</abbr>
    </bookgroup>
    <bookgroup id="4">
      <id>4</id>
      <name>Major Prophets</name>
      <ord>4</ord>
      <abbr>MAJP</abbr>
    </bookgroup>
    <bookgroup id="5">
      <id>5</id>
      <name>Minor Prophets</name>
      <ord>5</ord>
      <abbr>MINP</abbr>
    </bookgroup>
    <bookgroup id="6">
      <id>6</id>
      <name>Gospels</name>
      <ord>6</ord>
      <abbr>GOSP</abbr>
    </bookgroup>
    <bookgroup id="7">
      <id>7</id>
      <name>Letters From Paul</name>
      <ord>7</ord>
      <abbr>PAUL</abbr>
    </bookgroup>
    <bookgroup id="8">
      <id>8</id>
      <name>General Letters</name>
      <ord>8</ord>
      <abbr>GLET</abbr>
    </bookgroup>
    <bookgroup id="9">
      <id>9</id>
      <name>Deuterocanoical</name>
      <ord>9</ord>
      <abbr>DEUT</abbr>
    </bookgroup>
  </bookgroups>
  <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('51704a96eb3e57.02655235');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51704a96eb3e57.02655235" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>51704a96eb3e57.02655235</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('51704a96eb3e57.02655235'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51704a96eb3e57.02655235" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>

Returns a list of all book groups in all versions.

Show

GET /bookgroups/#{bookgroup_id}.xml

Returns the specified book grouping resource with the given ID. The bookgroup ID is an internal number, specific to the Bible Search API. All available group IDs are returned in the list of available book groups.

Example:

Request
XML
JSON
GET https://bibles.org/v2/bookgroups/1.xml
Response
<?xml version="1.0" encoding="utf-8"?>
<response>
  <bookgroups>
    <bookgroup id="1">
      <id>1</id>
      <name>Pentateuch</name>
      <ord>1</ord>
      <abbr>PENT</abbr>
    </bookgroup>
  </bookgroups>
  <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('51704aea9ebf40.67612622');\x3C/script\x3E");
</script><noscript><img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51704aea9ebf40.67612622" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" /></noscript>]]></fums>
    <fums_tid>51704aea9ebf40.67612622</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('51704aea9ebf40.67612622'); }]]></fums_js>
    <fums_noscript><![CDATA[<img src="https://d3a2okcloueqyx.cloudfront.net/nf1?t=51704aea9ebf40.67612622" height="1" width="1" border="0" alt="" style="height: 0; width: 0;" />]]></fums_noscript>
  </meta>
</response>