Developer Tools: API

Widget

Create

Highlighter - Beta

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

GET https://biblesearch.americanbible.org/bookgroups.xml

Response

<?xml version="1.0" encoding="utf-8"?>
<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>

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 BibleSearch API. All available group IDs are returned in the list of available book groups.